Instagram Graph API

Mengajukan Banding Produk Pengguna Instagram

Mewakili status banding produk yang ditolak. Lihat panduan Pelabelan Produk untuk detail penggunaan lengkap.

Membuat

POST /{ig-user-id}/product_appeal

Banding untuk produk yang ditolak.

Batasan

  • Akun Kreator Instagram tidak didukung.
  • Cerita, Instagram TV, Reels, Siaran Langsung, dan Mentions 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 yang disetujui 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

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &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.

appeal_reason

{appeal-reason}

Wajib. Penjelasan tentang mengapa produk harus disetujui.

product_id

{product-id}

Wajib. ID Produk.

Tanggapan

Objek yang menunjukkan kesuksesan atau kegagalan. Tanggapan tidak menunjukkan hasil banding.

{
  "success": {success}
}

Konten Tanggapan

PropertiNilai

success

Menunjukkan jika API menerima permintaan (true) atau tidak menerima permintaan (false). Tanggapan tidak menunjukkan hasil banding.

Contoh cURL

Permintaan

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/product_appeal?appeal_reason=product%20is%20a%20toy%20and%20not%20a%20real%20weapon&product_id=4382881195057752&access_token=EAAOc..."

Tanggapan

{
  "success": true
}

Membaca

GET /{ig-user-id}/product_appeal

Mendapatkan status banding tentang produk yang ditolak.

Batasan

  • Akun Kreator Instagram tidak didukung.
  • Cerita, Instagram TV, Reels, Siaran Langsung, dan Mentions 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 yang disetujui 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}/product_appeal
  ?product_id={product-id}
  &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.

product_id

{product-id}

Wajib. ID Produk.

Tanggapan

Objek berformat JSON berisi array metadata status banding.

{
  "data": [
    {
      "eligible_for_appeal": {eligible-for-appeal},
      "product_id": {product-id},
      "review_status": "{review-status}"
    }
  ]
}

Konten Tanggapan

PropertiNilai

eligible_for_appeal

Menunjukkan jika keputusan dapat diajukan banding (ya jika true, tidak jika false).

product_id

ID Produk.

review_status

Status tinjauan. Nilai dapat berupa:


  • approved — Produk disetujui.
  • rejected — Produk ditolak.
  • pending — Masih ditinjau.
  • outdated — Produk disetujui tetapi telah diedit dan membutuhkan persetujuan ulang.
  • "" — Tidak ada status tinjauan.
  • no_review — Tidak ada status tinjauan.

Contoh cURL

Permintaan

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

Tanggapan

{
  "data": [
    {
      "product_id": 4029274203846188,
      "review_status": "approved",
      "eligible_for_appeal": false
    }
  ]
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.