Instagram Graph API

Katalog yang Tersedia bagi Pengguna Instagram

Mewakili koleksi katalog produk di Instagram ShopPengguna Instagram. Lihat panduan Pelabelan Produk untuk detail penggunaan lengkap.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}/available_catalogs

Dapatkan katalog produk di Instagram ShopPengguna Instagram.

Batasan

  • Akun Kreator Instagram tidak didukung.
  • Cerita, Instagram TV, Reels, Siaran Langsung, dan Mentions tidak didukung.
  • Hanya menampilkan data di katalog tunggal karena Instagram Shop terbatas pada katalog tunggal.
  • Katalog kolaboratif (mitra belanja atau katalog kreator afiliasi) tidak didukung.

Persyaratan

JenisPersyaratan

Token Akses

Pengguna

Peran Bisnis

Pengguna aplikasi harus memiliki peran admin di Pengelola Bisnis yang memiliki Instagram Shop Pengguna Instagram.

Instagram Shop

Pengguna Instagram harus memiliki Instagram Shop dengan katalog produk berisi produk.

Izin

catalog_management
instagram_basic
instagram_shopping_tag_products
pages_show_list


Jika pengguna aplikasi diberi peran melalui Pengelola Bisnis di Halaman yang terhubung ke Pengguna Instagram target, Anda juga memerlukan salah satu dari:


ads_management
business_management

Sintaksis Permintaan

GET https://graph.facebook.com/{api-version}/{ig-user-id}/available_catalogs
  ?fields={fields}
  &access_token={access-token}

Parameter Jalur

PlaceholderNilai

{api-version}

Versi API.

{ig-user-id}

Wajib. ID pengguna lingkup aplikasi milik pengguna aplikasi.

Parameter String Kueri

KodePlaceholderNilai

access_token

{access-token}

Wajib. Token akses Pengguna aplikasi.

fields

{fields}

Kolom di daftar pengguna Instagram yang dipisahkan koma yang Anda ingin ditampilkan untuk setiap pengguna Instagram dalam set hasil.

Tanggapan

Objek berformat JSON berisi data yang Anda minta.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

Konten Tanggapan

PropertiNilai

catalog_id

ID Katalog.

catalog_name

Nama Katalog.

shop_name

Nama toko.

product_count

Jumlah produk dalam katalog. Mencakup semua produk tanpa memandang status ulasan.

Contoh cURL

Permintaan

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/available_catalogs?access_token=EAAOc..."

Tanggapan

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.