الطعن على منتج مستخدم IG

يمثل حالة الطعن على منتج مرفوض. راجع دليل الإشارة إلى المنتجات للحصول على تفاصيل كاملة حول الاستخدام.

الإنشاء

POST /{ig-user-id}/product_appeal

يمكنك الطعن على منتج مرفوض.

التقييدات

لا يتم دعم حسابات منشئي المحتوى في Instagram.
لا يتم دعم القصص وInstagram TV ومقاطع ريلز والبث المباشر وعمليات الذكر.

المتطلبات

النوع	المتطلب
رموز الوصول	المستخدم
أدوار النشاط التجاري	يجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يمتلك متجر Instagram التابع لمستخدم IG.
متجر Instagram	يجب أن يتوفر لدى مستخدم IG متجر Instagram معتمد يتضمن كتالوج منتجات يحتوي على المنتجات.
الأذونات	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` إذا تم منح مستخدم التطبيق دورًا في الصفحة المرتبطة بمستخدم IG المستهدف عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي: `ads_management` `business_management`

بنية الطلب

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &access_token={access-token}

معلمات المسار

العنصر النائب	القيمة
`{api-version}`	إصدار API.
`{ig-user-id}`	مطلوب. معرف المستخدم على مستوى التطبيق لدى مستخدم التطبيق.

معلمات سلسلة الاستعلام

المفتاح	العنصر النائب	القيمة
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`appeal_reason`	`{appeal-reason}`	مطلوب. تفسير سبب الموافقة على المنتج.
`product_id`	`{product-id}`	مطلوب. معرف المنتج.

الاستجابة

كائن يشير إلى نجاح أو فشل العملية. لا تشير الاستجابة إلى نتيجة الطعن.

{
  "success": {success}
}

محتويات الاستجابة

الخاصية	القيمة
`success`	تشير إلى ما إذا كانت API قد قبلت الطلب (`true`) أو لم تقبل الطلب (`false`). لا تشير الاستجابة إلى نتيجة الطعن.

مثال على cURL

الطلب

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..."

الاستجابة

{
  "success": true
}

القراءة

GET /{ig-user-id}/product_appeal

احصل على حالة الطعن على منتج مرفوض.

التقييدات

لا يتم دعم حسابات منشئي المحتوى في Instagram.
لا يتم دعم القصص وInstagram TV ومقاطع ريلز والبث المباشر وعمليات الذكر.

المتطلبات

النوع	المتطلب
رموز الوصول	المستخدم
أدوار النشاط التجاري	يجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يمتلك متجر Instagram التابع لمستخدم IG.
متجر Instagram	يجب أن يتوفر لدى مستخدم IG متجر Instagram معتمد يتضمن كتالوج منتجات يحتوي على المنتجات.
الأذونات	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` إذا تم منح مستخدم التطبيق دورًا في الصفحة المرتبطة بمستخدم IG المستهدف عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي: `ads_management` `business_management`

بنية الطلب

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

معلمات المسار

العنصر النائب	القيمة
`{api-version}`	إصدار API.
`{ig-user-id}`	مطلوب. معرف المستخدم على مستوى التطبيق لدى مستخدم التطبيق.

معلمات سلسلة الاستعلام

المفتاح	العنصر النائب	القيمة
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`product_id`	`{product-id}`	مطلوب. معرف المنتج.

الاستجابة

كائن بتنسيق JSON يحتوي على مصفوفة بيانات تعريف حالة الطعن.

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

محتويات الاستجابة

الخاصية القيمة

الخاصية	القيمة
`eligible_for_appeal`	يشير إلى ما إذا كان يمكن الطعن على القرار (يمكن ذلك إذا كانت القيمة `true` ويتعذر ذلك إذا كانت القيمة `false`).
`product_id`	معرف المنتج.
`review_status`	حالة المراجعة. يمكن أن تكون القيمة كما يلي: `approved` - تمت الموافقة على المنتج. `rejected` - تم رفض المنتج `pending` - لا يزال قيد المراجعة. `outdated` - تمت الموافقة على المنتج ولكن تم تعديله ويلزم إعادة الموافقة. `""` - لا توجد حالة مراجعة. `no_review` - لا توجد حالة مراجعة.

eligible_for_appeal

يشير إلى ما إذا كان يمكن الطعن على القرار (يمكن ذلك إذا كانت القيمة true ويتعذر ذلك إذا كانت القيمة false).

product_id

معرف المنتج.

review_status

حالة المراجعة. يمكن أن تكون القيمة كما يلي:

approved - تمت الموافقة على المنتج.
rejected - تم رفض المنتج
pending - لا يزال قيد المراجعة.
outdated - تمت الموافقة على المنتج ولكن تم تعديله ويلزم إعادة الموافقة.
"" - لا توجد حالة مراجعة.
no_review - لا توجد حالة مراجعة.

مثال على cURL

الطلب

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

الاستجابة

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

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.