الإشارة إلى المنتج

يمكنك استخدام واجهة Instagram Graph API لإنشاء إشارات منتجات التسوق في Instagram وإدارتها في وسائط IG في Instagram للأعمال.

ملاحظة: بدءًا من 10 أغسطس 2023، لن تتمكن بعض الأنشطة التجارية بدون المتاجر التي تتيح إتمام الشراء من الإشارة إلى المنتجات باستخدام API نشر المحتوى. سيؤثر ذلك على كل من واجهات API والواجهات الأصلية وسيعمل على إزالة الإشارات إلى المنتجات من منشورات سابقة. سيظل بإمكان العملاء الإشارة إلى المنتجات من المتاجر التي تتيح إتمام الشراء على فيسبوك وInstagram. لا يزال بإمكانك الرجوع إلى الحقل shopping_product_tag_eligibility للتحقق مما إذا كان حساب Instagram مؤهلاً للإشارة إلى المنتجات باستخدام API نشر المحتوى.

يتمثل الدفق العام للإشارة إلى المنتجات في:

التحقق مما إذا كان حساب Instagram للأعمال مؤهلاً للإشارة إلى المنتجات.
إذا كان حساب Instagram للأعمال مؤهلًا، فاحصل على كتالوجات المنتجات لديه.
البحث عن كل كتالوج منتجات مؤهل للإشارة.
إنشاء حاوية وسائط تمت الإشارة إليها.
نشر حاوية وسائط تمت الإشارة إليها.

التقييدات

تنطبق كل تقييدات نشر المحتوى على الإشارة إلى المنتجات.
الإشارة إلى المنتجات غير مدعومة للقصص والبث المباشر.
الإشارة إلى المنتجات غير مدعومة لحسابات منشئي محتوى Instagram.
تقتصر الحسابات على 25 منشور وسائط تتضمن إشارات خلال فترة 24 ساعة. تُعد ألبومات الإعلانات الدوّارة منشورًا فرديًا.

المتطلبات

ارجع إلى المستند المرجعي لكل نقطة نهاية لتحديد الأذونات والميزات ورموز وصول المستخدم المطلوبة لكل عملية.
يجب أن يتوفر لدى حساب Instagram للأعمال (مستخدم IG) الذي يملك وسائط IG (المطلوب الإشارة إليها) متجر Instagram معتمد يتضمن كتالوج منتجات يحتوي على منتجات. طرق إتمام الشراء الخارجية وداخل التطبيق في متجر Instagram مدعومة.
يجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يملك متجر Instagram الذي يتم استخدام منتجاته للإشارة إلى الوسائط.
لطلب إجراء عملية مراجعة التطبيقات لاعتماد الإذنين instagram_shopping_tag_products وcatalog_management، المطلوبين بواسطة العديد من نقاط نهاية الإشارة إلى منتجات، يجب أن يكون تطبيقك مرتبطًا بنشاط تجاري تم التحقق منه.

نقاط النهاية

GET /{ig-user-id} - التحقق من أهلية مستخدم التطبيق لاستخدام الإشارات.
GET /{ig-user-id}/available_catalogs - الحصول على قائمة بكتالوجات المنتجات لدى مستخدم التطبيق.
GET /{ig-user-id}/catalog_product_search - الحصول على قائمة بالمنتجات المؤهلة للإشارة في كتالوج مستخدم التطبيق.
POST /{ig-user-id}/media - إنشاء حاوية وسائط تمت الإشارة إليها (الخطوة الأولى من عملية النشر).
POST /{ig-user-id}/media_publish - نشر حاوية وسائط تمت الإشارة إليها (الخطوة الثانية من عملية النشر).
GET /{ig-media-id}/product_tags - الحصول على إشارات حول وسائط IG المنشورة.
DELETE /{ig-media-id}/product_tags - حذف الإشارات في وسائط IG المنشورة.
POST /{ig-media-id}/product_tags - إنشاء الإشارات أو تحديثها في وسائط IG المنشورة.
GET /{ig-user-id}/product_appeal - الحصول على معلومات حول الطعن على المنتج.
POST /{ig-user-id}/product_appeal - الطعن على رفض منتج.
GET /{ig-media-id}/children - الحصول على قائمة بوسائط IG التابعة في وسائط IG الإعلان الدوّار.

الحصول على أهلية المستخدم

اطلب الحقل shopping_product_tag_eligibility في نقطة النهاية مستخدم IG لتحديد ما إذا قام حساب Instagram للأعمال بإعداد متجر Instagram. ستكون الحسابات التي لم تقوم بإعداد متجر Instagram غير مؤهلة للإشارة إلى المنتجات.

GET /{ig-user-id}?fields=shopping_product_tag_eligibility

يتم إرجاع القيمة true إذا تم ربط حساب Instagram للأعمال بمتجر Instagram معتمد لدى لمدير الأعمال، وبخلاف ذلك يتم إرجاع false.

عينة من الطلب

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

عينة من الاستجابة

{
  "shopping_product_tag_eligibility": true,
  "id": "90010177253934"
}

الحصول على كتالوجات

استخدم نقطة نهاية كتالوجات مستخدم IG المتوفرة للحصول على كتالوج منتجات حساب Instagram للأعمال.

GET /{ig-user-id}/available_catalogs

يتم إرجاع مصفوفة من الكتالوجات وبيانات التعريف المرتبطة بها. ويمكن أن تتضمن الاستجابات حقول الكتالوج التالية:

catalog_id - معرف الكتالوج.
catalog_name - اسم الكتالوج.
shop_name - اسم المتجر.
product_count - إجمالي عدد المنتجات المتوفرة في الكتالوج.

التقييدات

لا يتم دعم الكتالوجات المساهمة مثل كتالوجات شركاء التسوق أو كتالوجات منشئي محتوى برنامج التسويق بالعمولة.

عينة من الطلب

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

عينة من الاستجابة

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

الحصول على المنتجات المؤهلة

استخدم نقطة نهاية البحث عن منتج في كتالوج مستخدم IG للحصول على مجموعة المنتجات المتوفرة في الكتالوج والتي يمكن استخدامها للإشارة إلى الوسائط. أشكال المنتج المتنوعة مدعومة.

على الرغم من أن API لن تُرجع خطأً عند نشر منشور تمت الإشارة إليه بمنتج غير معتمد، فإنه لن تظهر الإشارة في المنشور الذي تم نشره حتى تتم الموافقة على المنتج. ولذلك، نوصي فقط بالسماح لمستخدمي تطبيقك بنشر المنشورات التي تحتوي على إشارات تم تعيين الحالة review_status لمنتجاتها بالقيمة approved. كما يتم إرجاع هذا الحقل لكل منتج بشكل افتراضي عندما تحصل على المنتجات المؤهلة لدى مستخدم التطبيق.

GET /{ig-user-id}/catalog_product_search

المعلمات

catalog_id - (مطلوبة) معرف الكتالوج.
q - سلسلة يتم البحث عنها في كل اسم منتج أو رقم وحدة إدارة مخزون المنتج (عمود معرف المحتوى في واجهة إدارة الكتالوج). إذا لم يتم تحديد سلسلة، فسيتم إرجاع كل المنتجات المؤهلة للإشارة.

يتم إرجاع كائن يحتوي على مصفوفة من المنتجات المؤهلة للإشارة وبيانات التعريف المرتبطة بها. يتم دعم تقسيم الصفحات استنادًا إلى المؤشر. يمكن أن تتضمن الاستجابات حقول المنتج التالية:

image_url - عنوان URL لصورة المنتج.
is_checkout_flow إذا كان بالقيمة true، فيمكن شراء المنتج مباشرةً في تطبيق Instagram. إذا كانت القيمة false، فيجب شراء المنتج في تطبيق/موقع ويب مستخدم التطبيق.
merchant_id - معرف التاجر.
product_id - معرف المنتج.
product_name - اسم المنتج.
retailer_id - معرف بائع التجزئة.
review_status - حالة المراجعة. يمكن أن تتضمن القيم approved وoutdated وpending وrejected. يمكن أن يظهر المنتج الذي تمت الموافقة عليه في متجر Instagram لدى مستخدم التطبيق، ولكن لا تشير حالة الموافقة بضرورة توافر المنتج (مثال، يمكن أن يكون المنتج غير متوفر في المخزون). لا يمكن سوى للإشارات المرتبطة بمنتجات لديها review_status كـ approved الظهور في المنشورات التي تم نشرها.
product_variants - معرفات المنتجات (product_id) وأسماء الأشكال المتنوعة (variant_name) للأشكال المتنوعة للمنتجات.

عينة من الطلب

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

عينة من الاستجابة

{
  "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"
            }
          ]
    }
  ]
}

إنشاء حاوية تمت الإشارة إليها للصور أو مقاطع الفيديو

استخدم نقطة النهاية وسائط مستخدم IG لإنشاء حاوية وسائط لصورة أو فيديو. وبدلاً من ذلك، راجع إنشاء وسائط تمت الإشارة إليها لريلز أو الإعلانات الدوّارة.

POST /{ig-user-id}/media

المعلمات

image_url — (مطلوبة للصور فقط) تمثل مسار الصورة. يجب أن تكون الصورة على خادم عام.
user_tags - تمثل مصفوفة بأسماء المستخدمين العامة وإحداثيات x/y لأي مستخدم Instagram عام تريد الإشارة إليه في الصورة. يجب أن يتم تنسيق المصفوفة بلغة JSON وأن تحتوي على الخاصية username وx وy. على سبيل المثال، يجب أن تكون القيم [{username:'natgeo',x:0.5,y:1.0}] وx وy أرقام صحيحة عشرية تبدأ من أعلى يسار الصورة بنطاق يتراوح من 0.0 إلى 1.0. سيتلقى المستخدمون الذين تمت الإشارة إليهم إشعارًا عندما يتم نشر الوسائط.
video_url — (مطلوبة لمقاطع الفيديو فقط) تمثل مسار الفيديو. يجب أن يكون الفيديو على خادم عام.
thumb_offset - (مقاطع الفيديو فقط) يمثل موقع الإطار، بالمللي ثانية، للصورة المصغرة لغلاف الفيديو. تكون القيمة الافتراضية 0، والتي تمثل الإطار الأول في الفيديو.
product_tags - (مطلوب) مصفوفة كائنات تحدد الإشارات إلى المنتجات لإضافتها إلى الصورة أو الفيديو. يمكنك تحديد ما يصل إلى 20 إشارة لمنشورات موجز الصورة والفيديو وما يصل إلى 20 إشارة كإجمالي لكل منشور إعلان دوّار (ما يصل إلى 5 لكل شريحة إعلان دوّار).
- يجب أن تكون الإشارات ومعرفات المنتج فريدة.
- إشارات المنتجات غير المتوفرة في المخزون مدعومة.
- يجب أن تتوفر لدى كل كائن المعلومات التالية:
  - product_id - (مطلوبة) معرف المنتج.
  - x - (الصور فقط) تمثل عدد صحيح عشري يشير إلى المسافة المئوية من الطرف الأيسر لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق 0.0-1.0.
- y - (الصور فقط) تمثل عدد صحيح عشري يشير إلى المسافة المئوية من الطرف العلوي لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق 0.0-1.0.

إذا كانت العملية ناجحة، فستعرض API معرف الحاوية الذي يمكنك استخدامه لنشر الحاوية.

عينة من الطلب

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media?image_url=https%3A%2F%2Fupl...&location_id=7640348500&product_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3231775643511089'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

كمرجع في المستقبل، فيما يلي مثال على سلسلة حمولة بيانات طلب POST التي تم فك تشفيرها بتنسيق HTML:

https://graph.facebook.com/v12.0/90010177253934/media?image_url=https://upl...&location_id=7640348500 &product_tags=[ { product_id:'3231775643511089', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

عينة من الاستجابة

{
  "id": "17969578066508312"
}

إنشاء حاوية تمت الإشارة إليها لريلز

استخدم نقطة النهاية وسائط مستخدم IG لإنشاء حاوية وسائط لريلز. وبدلاً من ذلك، راجع إنشاء وسائط تمت الإشارة إليها أو الإعلانات الدوّارة.

POST /{ig-user-id}/media

المعلمات

media_type - عليك تحديد نوع الوسائط REELS.
video_url - مسار الفيديو لمقطع ريلز. يجب أن يكون الفيديو على خادم عام. يجب أن يلبي الفيديو مواصفات ريلز.
thumb_offset - يمثل موقع الإطار، بالمللي ثانية، للصورة المصغرة لغلاف الفيديو. تكون القيمة الافتراضية 0، والتي تمثل الإطار الأول في الفيديو.
caption - يمثل شرحًا توضيحيًا لمقطع ريلز.
product_tags - (مطلوب) مصفوفة كائنات تحدد الإشارات إلى المنتجات لإضافتها إلى مقطع ريلز. يمكنك تحديد ما يصل إلى 30 إشارة ويجب أن تكون الإشارات ومعرفات المنتجات فريدة. إشارات المنتجات غير المتوفرة في المخزون مدعومة. يجب أن تتوفر لدى كل كائن المعلومات التالية:
- product_id - (مطلوبة) معرف المنتج.
location_id - معرف الصفحة المرتبطة بالموقع الذي تريد الإشارة إليه في الفيديو. للحصول على التفاصيل، راجع معلمات سلسلة استعلام الوسائط لمستخدم IG.
share_to_feed - true لطلب ظهور الفيديو في كل من علامتي تبويب الموجز وريلز. false لطلب ظهور الفيديو في علامة تبويب ريلز فقط.
access_token - رمز وصول المستخدم لديك.

إذا كانت العملية ناجحة، فستعرض API معرف الحاوية الذي يمكنك استخدامه لنشر الحاوية.

عينة من الطلب

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media?media_type=REELS&video_url=https://upl...&product_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3231775643511089'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

كمرجع في المستقبل، فيما يلي مثال على سلسلة حمولة بيانات طلب POST التي تم فك تشفيرها بتنسيق HTML:

https://graph.facebook.com/v12.0/90010177253934/media?media_type=REELS&video_url=https://upl... &product_tags=[ { product_id:'3231775643511089' } ]&access_token=EAAOc...

عينة من الاستجابة

{
  "id": "17969578066508312"
}

نشر حاوية وسائط تمت الإشارة إليها

استخدم نقطة نهاية نشر وسائط مستخدم IG لنشر حاوية الوسائط التي تمت الإشارة إليها. يمكنك نشر ما يصل إلى 25 حاوية وسائط تمت الإشارة إليها نيابة عن مستخدم التطبيق خلال فترة تبلغ 24 ساعة. إذا كنت تنشر إعلانًا دوّارًا، فراجع الإعلانات الدوّارة. لن تظهر سوى المنتجات التي لديها review_status كـ approved في المنشورات التي تم نشرها. إذا نفد أي من هذه المنتجات من المخزون، فستظل إشاراته تظهر في المنشور الذي تم نشره.

POST /{ig-user-id}/media_publish

المعلمات

creation_id — (مطلوبة) تمثل معرف حاوية الإعلان الدوّار.

إذا كانت العملية ناجحة، فسترجع API معرف وسائط IG.

عينة من الطلب

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media_publish?creation_id=17969578066508312&access_token=EAAOc"

عينة من الاستجابة

{
  "id": "90010778325754"
}

الحصول على الإشارات الموجودة في الوسائط

استخدم نقطة نهاية عمليات الإشارة إلى المنتجات في وسائط IG للحصول على الإشارات في الوسائط المنشورة.

GET /{ig-media-id}/product_tags

يتم إرجاع مصفوفة بإشارات المنتجات وبيانات التعريف المرتبطة بها في وسائط IG. يمكن أن تتضمن الاستجابات حقول الإشارة إلى المنتجات التالية:

product_id - معرف المنتج.
merchant_id - معرف التاجر.
name - اسم المنتج.
price_string - سعر المنتج.
image_url - عنوان URL لصورة المنتج.
review_status - تشير إلى حالة أهلية الإشارة إلى المنتج. يمكن أن تكون القيم كما يلي:
approved - تمت الموافقة على المنتج.
rejected - تم رفض المنتج.
pending - لا يزال قيد المراجعة.
outdated - تمت الموافقة على المنتج ولكن تم تعديله ويلزم إعادة الموافقة.
"" - لا توجد حالة مراجعة.
no_review - لا توجد حالة مراجعة.
is_checkout - إذا كانت القيمة true، فيمكن شراء المنتج مباشرةً في تطبيق Instagram. وإذا كانت القيمة false، فلا يمكن شراء المنتج إلا من خلال موقع ويب التاجر.
stripped_price_string - سلسلة سعر المنتج القصيرة (السعر المعروض في مساحات محدودة، مثل $100 بدلاً من 100 USD).
string_sale_price_string - سعر بيع المنتج.
x - رقم صحيح عشري يشير إلى المسافة المئوية من الطرف الأيسر لصورة الوسائط. تكون القيم بين نطاق يتراوح من 0.0 إلى 1.0.
y - رقم صحيح عشري يشير إلى المسافة المئوية من الطرف العلوي لصورة الوسائط. تكون القيم بين نطاق يتراوح من 0.0 إلى 1.0.

عينة من الطلب

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

عينة من الاستجابة

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "name": "Gummy Wombats",
      "price_string": "$3.50",
      "image_url": "https://scont...",
      "review_status": "approved",
      "is_checkout": true,
      "stripped_price_string": "$3.50",
      "x": 0.5,
      "y": 0.80000001192093
    }
  ]
}

الإشارة إلى الوسائط الحالية

استخدم نقطة نهاية إشارات المنتجات في وسائط IG لإنشاء إشارات في وسائط IG الحالية أو تحديثها.

POST /{ig-media-id}/product_tags

المعلمات

updated_tags - (مطلوبة) مصفوفة من الكائنات تحدد إشارات المنتجات التي يمكن استخدامها في الصورة أو الفيديو (بحد أقصى 5 إشارات، يجب أن تكون الإشارات ومعرفات المنتجات فريدة). يجب أن تتوفر لدى كل كائن المعلومات التالية:
product_id - (مطلوبة) معرف المنتج. إذا لم تتم الإشارة إلى وسائط IG بهذا المعرف، فستتم إضافة الإشارة إلى وسائط IG. وإذا تمت بالفعل الإشارة إلى الوسائط بهذا المعرف، فسيتم تحديث إحداثيات عرض الإشارة.
x - (الصور فقط، مطلوبة) تمثل عدد صحيح عشري يشير إلى المسافة المئوية من الطرف الأيسر لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق 0.0-1.0.
y - (الصور فقط، مطلوب) تمثل عدد صحيح عشري يشير إلى المسافة المئوية من الطرف العلوي لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق 0.0-1.0.

يمكن استخدام الإشارة إلى الوسائط بشكل تراكمي حتى يتم الوصول إلى تقييد الإشارة البالغ 5 إشارات. إذا تمت بالفعل الإشارة إلى الوسائط المستهدفة من خلال منتج ما في الطلب، فسيتم تحديث قيم x وy للإشارة القديمة بالقيم الجديدة (لن تتم إضافة إشارة جديدة).

يتم إرجاع القيمة true إذا أمكن تحديث المنتج، وبخلاف ذلك يتم إرجاع القيمة false.

عينة من الطلب

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

كمرجع في المستقبل، فيما يلي مثال على سلسلة حمولة بيانات طلب POST التي تم فك تشفيرها بتنسيق HTML:

https://graph.facebook.com/v12.0/90010778325754/product_tags?updated_tags=[ { product_id:'3859448974125379', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

عينة من الاستجابة

{
  "success": true
}

حذف الإشارات

استخدم نقطة نهاية عمليات الإشارة إلى المنتجات في وسائط IG لحذف الإشارات في وسائط IG المنشورة التي تتضمن ريلز.

DELETE /{ig-media-id}/product_tags

المعلمات

deleted_tags - (مطلوبة) مصفوفة تحتوي على المعلومات التالية لكل إشارة إلى منتج يجب حذفها:
merchant_id - (مطلوبة) معرف التاجر.
product_id - (مطلوبة) معرف المنتج.

يتم إرجاع القيمة true إذا كانت عملية حذف الإشارة ناجحة، وبخلاف ذلك يتم إرجاع القيمة false.

عينة من الطلب

curl -i -X DELETE \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?deleted_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20merchant_id%3A'90010177253934'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

كمرجع في المستقبل، فيما يلي مثال على سلسلة حمولة بيانات طلب POST التي تم فك تشفيرها بتنسيق HTML:

https://graph.facebook.com/v12.0/90010778325754/product_tags?deleted_tags=[ { product_id:'3859448974125379', merchant_id:'90010177253934' } ]&access_token=EAAOc...

عينة من الاستجابة

{
  "success": true
}

الطعن على رفض المنتج

استخدم نقطة نهاية الطعن على منتج مستخدم IG إذا أردت توفير طريقة لمستخدمي تطبيقك للطعن على عمليات رفض المنتجات (لن تظهر إشارات المنتجات المرفوضة في المنشورات التي تم نشرها). على الرغم من أنه أمر غير مطلوب، فإننا نوصي بتوفير طريقة لمستخدمي التطبيق للطعن على عمليات الرفض أوحثهم على الطعن على عمليات الرفض باستخدام مدير الأعمال.

POST /{ig-user-id}/product_appeal

المعلمات

appeal_reason - (مطلوبة) توضح سبب الموافقة على المنتج.
product_id - (مطلوبة) معرف المنتج.

يتم إرجاع القيمة true إذا تمكنا من تلقي طلبك، وبخلاف ذلك يتم إرجاع القيمة false. لا تشير الاستجابة إلى نتيجة الطعن.

عينة من الطلب

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
}

الحصول على حالة الطعن

استخدم نقطة نهاية الطعن على منتج مستخدم IG للحصول على حالة الطعن على المنتج الذي تم رفضه:

GET /{ig-user-id}/product_appeal

المعلمات

product_id - (مطلوبة) معرف المنتج.

يتم إرجاع بيانات تعريفية حول حالة الطعن. يمكن أن تتضمن الاستجابات حقول الطعن التالية:

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

عينة من الطلب

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
    }
  ]
}

الإعلانات الدوّارة

يمكنك نشر الإعلانات الدوّارة (الألبومات) التي تحتوي على ما يصل إلى إجمالي 10 صور أو مقاطع فيديو تمت الإشارة إليها أو مزيج من الاثنين. لإجراء ذلك، عند إجراء الخطوة 1 من 3 لعملية نشر منشورات الإعلانات الدوّارة، ما عليك سوى إنشاء حاويات وسائط تمت الإشارة إليها لكل صورة أو فيديو تمت الإشارة إليه والذي تريد عرضه في إعلان الألبوم الدوّار ومتابعة عمليات نشر الإعلان الدوّار كما تفعل عادةً.

الحصول على وسائط تابعة في الإعلان الدوّار

للحصول على معرفات وسائط IG في إعلان الألبوم الدوّار، استخدم نقطة نهاية العناصر التابعة في وسائط IG.