Ringkasan

Instagram Graph API adalah koleksi endpoint Facebook Graph API yang mengizinkan aplikasi mengakses data di akun Profesional Instagram (baik akun Instagram Business maupun akun Kreator Instagram). Jika Anda belum terbiasa dengan Facebook Graph API, bacalah dokumentasi Graph API kami sebelum melanjutkan.

URL Dasar

Semua endpoint dapat diakses melalui host graph.facebook.com.

Pengguna Aplikasi

Akun Profesional Instagram diakses secara tidak langsung melalui akun Facebook sehingga pengguna aplikasi Anda harus memiliki akun Facebook dan menggunakannya saat masuk ke aplikasi Anda. Selain itu, akun Facebook harus dapat melakukan Tugas setara admin di Halaman Facebook yang telah terhubung ke akun Instagram yang mereka coba akses.

Persyaratan ini berlaku untuk semua pengguna aplikasi, bahkan mereka yang memiliki Peran di aplikasi Anda atau Peran di Bisnis yang telah mengeklaim aplikasi Anda.

Autentikasi

Autentikasi pengguna aplikasi ditangani melalui token akses. Akun profesional Instagram diakses secara tidak langsung melalui akun Facebook, jadi semua permintaan API harus menyertakan token akses Pengguna Facebook milik pengguna aplikasi Anda. Anda bisa mendapatkan token dari pengguna aplikasi dengan menerapkan Facebook Login. Harap diingat bahwa Facebook Login tidak mendukung kredensial Instagram sehingga pengguna aplikasi harus masuk menggunakan akun Facebook.

Otorisasi

Otorisasi endpoint ditangani melalui izin dan fitur. Sebelum aplikasi Anda dapat menggunakan endpoint untuk mengakses data Instagram pengguna aplikasi, Anda harus terlebih dahulu meminta semua izin yang diperlukan oleh endpoint tersebut dari pengguna aplikasi. Pengguna aplikasi kemudian harus memberikan izin tersebut ke aplikasi Anda. Setelah diberikan, Anda dapat meminta endpoint untuk mengakses data pengguna.

Perhatikan bahwa izin hanya mengizinkan akses ke data yang dibuat oleh pengguna yang memberikan izin tersebut. Ada beberapa endpoint yang memungkinkan aplikasi mengakses data yang tidak dibuat oleh pengguna aplikasi, tetapi data yang dapat diakses terbatas dan bersifat publik.

Anda dapat meminta izin dari pengguna aplikasi dengan menerapkan Facebook Login. Pengguna aplikasi yang memiliki peran di aplikasi Anda dapat memberikan izin yang diminta. Pengguna aplikasi yang tidak memiliki peran pada aplikasi Anda hanya dapat memberikan izin dan fitur yang telah disetujui melalui proses Tinjauan Aplikasi.

API menggunakan Izin dan Fitur berikut:

• instagram_basic
• instagram_content_publish
• instagram_manage_comments
• instagram_manage_insights
• instagram_shopping_tag_products
• pages_show_list
• pages_read_engagement
• Akses Konten Publik Instagram

Baca referensi endpoint kami untuk menentukan izin dan fitur mana yang perlu diminta aplikasi Anda dari pengguna aplikasi.

Berkirim Pesan di Instagram

Jika Anda berencana untuk menerapkan Berkirim Pesan di Instagram dari Platform Messenger, Anda harus menyertakan izin instagram_manage_messages. Pelajari selengkapnya tentang Berkirim Pesan di Instagram.

Kolaborator

Fitur Kolaborasi Instagram memungkinkan pengguna aplikasi Instagram untuk bersama-sama menulis konten (yaitu menerbitkan media) dengan akun lain (kolaborator).

Dengan beberapa pengecualian, data tentang atau media yang ditulis bersama hanya dapat diakses melalui API oleh pengguna yang menerbitkan media; kolaborator tidak dapat mengakses data ini melalui API. Satu-satunya pengecualian adalah ketika mencari media dengan kinerja terbaik atau media terbaru yang diterbitkan dengan tanda tagar tertentu. Lihat Pencarian Tagar.

Halaman

Akun Profesional Instagram harus terhubung ke Halaman Facebook sebelum datanya dapat diakses melalui API. Setelah terhubung, Pengguna Facebook yang mampu melakukan Tugas di Halaman tersebut dapat memberi aplikasi Anda token akses, yang kemudian dapat digunakan dalam permintaan API.

Artikel bantuan Menambahkan atau mengubah Halaman Facebook yang terhubung ke akun profesional Instagram Anda menjelaskan cara menghubungkan Halaman Facebook ke akun Profesional Instagram.

Tugas

Agar pengguna aplikasi dapat memberikan izin aplikasi Anda, pengguna aplikasi tersebut harus dapat melakukan tugas di Halaman Facebook yang terhubung ke akun Instagram yang mereka coba akses. Pengguna aplikasi dapat memberikan izin aplikasi Anda berdasarkan tugas yang dapat mereka lakukan sebagai berikut:

Anda dapat menentukan tugas mana yang dapat dilakukan pengguna aplikasi di Halaman dengan membuat kueri endpoint GET /me/accounts dengan token akses Pengguna milik pengguna aplikasi. Endpoint akan menampilkan daftar Halaman tempat pengguna aplikasi dapat melakukan tugasnya, dan menunjukkan tugas mana yang dapat dilakukan pengguna pada masing-masing halaman.

Baca dokumentasi referensi untuk melihat izin apa yang diperlukan tiap endpoint. API tidak mendukung Pengguna Sistem Pengelola Bisnis, atau pengguna aplikasi yang memiliki peran Kontributor Siaran Langsung.

Merujuk ke tugas

Jika Anda perlu memberi tahu pengguna aplikasi Anda tentang tugas (dan mana yang diperlukan untuk menggunakan aplikasi Anda dengan benar), berikut ini bagaimana tugas dirujuk di berbagai UI kami.

Halaman Klasik

Halaman Klasik merujuk ke tugas sebagai peran. Pengguna aplikasi dengan peran Admin di Halaman dapat memberikan izin apa pun kepada aplikasi Anda. Pengguna aplikasi dengan peran lain dapat memberikan izin sebagai berikut:

Pengalaman Halaman Baru

Halaman Pengalaman Baru merujuk ke tugas sebagai Akses Facebook atau Akses Tugas. Pengguna aplikasi dengan Akses Facebook di Halaman dapat memberikan izin apa pun kepada aplikasi Anda. Pengguna aplikasi dengan Akses Tugas dapat memberikan izin sebagai berikut:

Untuk menentukan apakah Halaman menggunakan pengalaman baru, mintalah kolom has_transitioned_to_new_page_experience. Nilai ini memberikan true jika Halaman menggunakan pengalaman baru.

Tinjauan Aplikasi

Aplikasi Anda harus menyelesaikan Tinjauan Aplikasi sebelum dapat digunakan pengguna aplikasi yang tidak memiliki Peran di aplikasi Anda atau Peran di Bisnis yang telah mengeklaim aplikasi Anda. Jika aplikasi Anda hanya akan digunakan oleh pengguna aplikasi yang memiliki Peran di aplikasi atau Bisnis Anda, Anda tidak perlu menyelesaikan Tinjauan Aplikasi.

Pengajuan Tinjauan Aplikasi Anda tidak perlu menyertakan kredensial pengguna uji Facebook jika Anda telah menerapkan Facebook Login dan aplikasi Anda telah tersedia untuk publik. Namun, jika peninjau kami perlu masuk ke akun non-Facebook untuk memicu penerapan Facebook Login, Anda harus menyertakan kredensial akun non-Facebook dalam pengajuan Anda.

Aplikasi Pribadi

Jika peninjau kami tidak dapat menguji aplikasi Anda karena berada di belakang intranet pribadi, tidak memiliki antarmuka pengguna, atau belum menerapkan Facebook Login, Anda hanya dapat meminta persetujuan untuk Izin ini:

• instagram_basic
• instagram_manage_comments

Verifikasi Bisnis

Anda harus menyelesaikan Verifikasi Bisnis jika aplikasi Anda akan digunakan oleh pengguna aplikasi yang tidak memiliki Peran di aplikasi itu sendiri, atau Peran dalam Bisnis yang telah mengeklaim aplikasi tersebut.

Pembatasan Laju

Semua endpoint mematuhi pembatasan laju Kasus Penggunaan kecuali untuk endpoint Penemuan Bisnis dan Pencarian Tagar, yang mematuhi Pembatasan Laju Platform.

Webhooks

Anda dapat menggunakan Webhooks agar notifikasi dikirimkan kepada Anda setiap kali seseorang mengomentari objek media pengguna aplikasi Anda atau ketika salah satu cerita mereka kedaluwarsa. Baca dokumentasi Webhooks kami untuk mempelajari cara menggunakan Webhook, lalu menyiapkan webhook untuk topik Instagram serta berlangganan ke kolom comments dan story_insights.

Berkirim Pesan di Instagram

Beberapa endpoint Instagram Graph API digunakan bersama dengan endpoint Platform Messenger untuk memungkinkan pengguna aplikasi Anda berinteraksi dengan pesan direct yang dikirim ke akun Profesional Instagram mereka. Baca dokumentasi Berkirim Pesan di Instagram untuk Platform Instagram guna mempelajari cara mengakses pesan di akun Instagram Business.