Pencarian Produk Katalog Pengguna Instagram

Mewakili produk dan varian produk yang cocok dengan string pencarian tertentu dalam katalog produk Instagram Shop milik Pengguna Instagram. Lihat panduan Pelabelan Produk untuk detail penggunaan lengkap.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}/catalog_product_search

Dapatkan koleksi produk yang cocok dengan string pencarian tertentu dalam target katalog Instagram Shop milik Pengguna Instagram.

Batasan

Akun Kreator Instagram tidak didukung.
Cerita, Instagram TV, Reels, Siaran Langsung, dan Mentions tidak didukung.
Produk dengan review_statusrejected akan ditampilkan, namun Media Instagram tidak dapat ditandai dengan produk yang ditolak.
Meskipun API tidak akan menampilkan kesalahan saat menerbitkan postingan yang ditandai dengan produk yang tidak disetujui, tanda tersebut tidak akan muncul pada postingan yang diterbitkan sampai produk disetujui. Oleh karena itu, kami rekomendasikan Anda hanya mengizinkan pengguna aplikasi Anda untuk menerbitkan postingan dengan tanda yang produknya memiliki review_status dari approved. Kolom ini ditampilkan untuk setiap produk secara default saat Anda mendapatkan produk yang memenuhi syarat dari pengguna aplikasi.

Persyaratan

Jenis	Persyaratan
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}/catalog_product_search
  ?catalog_id={catalog-id}
  &q={q}
  &access_token={access-token}

Parameter Jalur

Placeholder	Nilai
`{api-version}`	Versi API.
`{ig-user-id}`	Wajib. ID pengguna lingkup aplikasi milik pengguna aplikasi.

Parameter String Kueri

Kode	Placeholder	Nilai
`access_token`	`{access-token}`	Wajib. Token akses Pengguna aplikasi.
`catalog_id`	`{catalog-id}`	Wajib. ID katalog untuk dicari.
`q`	`{q}`	String pencarian di setiap nama produk atau nomor SKU (nomor SKU dapat ditambahkan di kolom ID Konten di antarmuka pengelolaan katalog). Jika tidak ada string yang ditentukan, semua produk yang memenuhi syarat label akan ditampilkan.

Tanggapan

Objek yang diformat JSON berisi array produk yang memenuhi syarat label dan metadata mereka. Mendukung paginasi berbasis kursor.

{
  "data": [
    {
      "product_id": {product-id},
      "merchant_id": {merchant-id},
      "product_name": "{product-name}",
      "image_url": "{image-url}",
      "retailer_id": "{retailer-id}",
      "review_status": "{review-status}",
      "is_checkout_flow": {is-checkout-flow}
    }
  ]
}

Konten Tanggapan

Properti	Nilai
`product_id`	ID Produk.
`merchant_id`	ID Pelapak.
`product_name`	Nama produk.
`image_url`	URL gambar produk.
`retailer_id`	ID peritel.
`review_status`	Status tinjauan. Nilai dapat berupa `approved`, `outdated`, `pending`, `rejected`. Produk yang disetujui dapat muncul di Instagram Shop milik pengguna aplikasi, tetapi status yang disetujui tidak menunjukkan ketersediaan produk (misalnya: stok produknya mungkin habis). Hanya label terkait produk yang memiliki `review_status` dari `approved` yang dapat muncul di postingan yang diterbitkan.
`is_checkout_flow`	Jika `true`, produk bisa dibeli langsung di aplikasi Instagram. Jika `false`, produk harus dibeli di aplikasi/situs web pengguna aplikasi.
`product_variants`	ID Produk (`product_id`) dan nama varian (`variant_name`) dari varian produk.

Contoh cURL

Permintaan

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/catalog_product_search?catalog_id=960179311066902&q=gummy&access_token=EAAOc"

Tanggapan

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "product_name": "Gummy Wombats",
      "image_url": "https://scont...",
      "retailer_id": "oh59p9vzei",
      "review_status": "approved",
      "is_checkout_flow": true,
      "product_variants": [
            {
              "product_id": 5209223099160494
            },
            {
              "product_id": 7478222675582505,
              "variant_name": "Green Gummy Wombats"
            }
          ]
    }
  ]
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.