Platform Instagram

Memulai

Dokumen ini menjelaskan cara agar berhasil memanggil Instagram Graph API dengan aplikasi Anda dan mendapatkan objek media Akun Instagram Business atau Akun Kreator Instagram. Ini mengasumsikan Anda sudah familiar dengan Graph API dan Facebook Login, dan mengetahui cara melakukan panggilan REST API. Jika belum memiliki aplikasi, Anda bisa menggunakan Graph API Explorer dan melompati langkah 1 dan 2.

Sebelum Memulai

Anda akan memerlukan akses ke beberapa hal berikut:

1. Mengonfigurasi Facebook Login

Tambahkan produk Facebook Login ke aplikasi Anda di Dasbor Aplikasi.

Anda dapat membiarkan semua pengaturan pada defaultnya. Jika Anda menerapkan Facebook Login secara manual (yang tidak kami rekomendasikan), masukkan redirect_uri di kolom URI pengarahan ulang OAuth valid. Jika Anda akan menggunakan salah satu SDK kami, Anda dapat mengosongkannya.

2. Menerapkan Facebook Login

Ikuti dokumentasi Facebook Login kami untuk platform Anda dan terapkan Facebook Login ke aplikasi Anda. Siapkan implementasi Anda untuk meminta izin ini:

3. Mendapatkan Token Akses Pengguna

Setelah menerapkan Facebook Login, pastikan Anda masuk ke akun Developer Facebook, lalu akses aplikasi dan mulai modal Facebook Login. Ingat, akun Developer Facebook harus dapat melakukan Tugas di Halaman Facebook yang terhubung ke akun Instagram yang ingin Anda kueri.

Setelah Anda memicu modal, klik OK untuk memberi aplikasi Anda izin instagram_basic dan pages_show_list.

API akan memberikan token akses Pengguna. Ambil gambar token sehingga aplikasi Anda dapat menggunakannya pada beberapa kueri berikutnya. Jika Anda menggunakan Graph API Explorer, gambarnya akan diambil secara otomatis dan ditampilkan di kolom Token Akses sebagai referensi:

4. Mendapatkan Halaman Pengguna

Kueri endpoint GET /me/accounts (ini diterjemahkan menjadi GET /{user-id}/accounts, yang melakukan GET di node Pengguna Facebook, berdasarkan token akses Anda).

curl -i -X GET \
 "https://graph.facebook.com/v19.0/me/accounts?access_token={access-token}"

Ini akan menampilkan koleksi Halaman Facebook tempat Pengguna Facebook saat ini dapat melakukan tugas MANAGE, CREATE_CONTENT, MODERATE, atau ADVERTISE:

{
  "data": [
    {
      "access_token": "EAAJjmJ...",
      "category": "App Page",
      "category_list": [
        {
          "id": "2301",
          "name": "App Page"
        }
      ],
      "name": "Metricsaurus",
      "id": "134895793791914",  // capture the Page ID
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    }
  ]
}

Ambil gambar ID Halaman Facebook yang terhubung ke akun Instagram yang ingin Anda kueri. Perlu diingat bahwa pengguna aplikasi Anda mungkin dapat melakukan tugas di beberapa halaman, jadi pada akhirnya Anda harus memperkenalkan logika yang dapat menentukan ID Halaman yang benar untuk diambil gambarnya (atau merancang UI tempat pengguna aplikasi Anda dapat mengidentifikasi Halaman yang tepat untuk Anda).

5. Mendapatkan Akun Instagram Business milik Halaman

Gunakan ID Halaman yang Anda ambil gambarnya untuk meng-kueri endpoint GET /{page-id}?fields=instagram_business_account:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/134895793791914?fields=instagram_business_account&access_token={access-token}"

Ini akan menampilkan Pengguna Instagram — Akun Instagram Business atau Akun Kreator Instagram — yang terhubung ke Halaman Facebook.

{
  "instagram_business_account": {
    "id": "17841405822304914"  // Connected IG User ID
  },
  "id": "134895793791914"  // Facebook Page ID
}

Ambil gambar ID Pengguna Instagram.

6. Mendapatkan Objek Media Akun Instagram Business

Gunakan ID Pengguna Instagram yang Anda ambil gambarnya untuk meng-kueri endpoint GET /{ig-user-id}/media:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17841405822304914/media?access_token={access-token}"

Ini akan menampilkan ID dari semua objek Media Instagram pada Pengguna Instagram:

{
  "data": [
    {
      "id": "17918195224117851"
    },
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUkdGRXA2eHNNTUs4T1ZAXNGFxQTAtd3U4QjBLd1B2NXRMM1NkcnhqRFdBcEUzSDVJZATFoLWtXMWZAGU2VrRTk2RHVtTVlDckI2NjN0UERFa2JrUk4yMW13",
      "after": "QVFIUmlwbnFsM3N2cV9lZAFdCa0hDeV9qMVliT0VuMmJyNENxZA180c0t6VjFQVEJaTE9XV085aU92OUFLNFB6Szd2amo5aV9rTlVBcnNlWmEtMzYxcE1HSFR3"
    }
  }
}

Jika Anda berhasil melakukan kueri akhir ini, Anda harus dapat melakukan kueri menggunakan salah satu endpoint Instagram Graph API — cukup lihat berbagai panduan dan referensi kami untuk mempelajari apa yang dapat dilakukan setiap endpoint dan izin apa yang mereka perlukan.

Langkah Berikutnya

  • Kembangkan aplikasi Anda lebih jauh agar dapat berhasil menggunakan endpoint lain yang diperlukan, dan terus lacak izin yang diperlukan setiap endpoint
  • Selesaikan proses Tinjauan Aplikasi dan minta persetujuan untuk semua izin yang diperlukan aplikasi Anda sehingga pengguna aplikasi dapat memberikannya saat aplikasi Anda dalam Mode Aktif
  • Alihkan aplikasi Anda ke Mode Aktif dan pasarkan ke calon pengguna

Setelah aplikasi Anda dalam Mode Aktif, setiap Pengguna Facebook yang telah Anda sediakan aplikasi ini dapat mengakses data Akun Instagram Business atau Akun Kreator Instagram, selama mereka memiliki akun Pengguna Facebook yang dapat melakukan Tugas di Halaman yang terhubung ke Akun Instagram Business atau Akun Kreator Instagram tersebut.