كتالوجات مستخدم IG المتوفرة

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

الإنشاء

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

القراءة

GET /{ig-user-id}/available_catalogs

احصل على كتالوج المنتج في متجر Instagram لدى مستخدم IG.

التقييدات

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

المتطلبات

النوع	المتطلب
رموز الوصول	المستخدم
أدوار النشاط التجاري	يجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يمتلك متجر 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}/available_catalogs
  ?fields={fields}
  &access_token={access-token}

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

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

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

المفتاح	العنصر النائب	القيمة
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`fields`	`{fields}`	يمثل قائمة مفصولة بفاصلة تتضمن حقول الكتالوج التي تريد إرجاعها لكل كتالوج في مجموعة النتائج.

الاستجابة

كائن بتنسيق لغة JSON يتضمن البيانات التي طلبتها.

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

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

الخاصية	القيمة
`catalog_id`	معرف الكتالوج.
`catalog_name`	اسم الكتالوج.
`shop_name`	اسم المتجر.
`product_count`	عدد المنتجات في الكتالوج. يتضمن كل المنتجات بغض النظر عن حالة المراجعة.

مثال على cURL

الطلب

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

الاستجابة

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

التحديث

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

الحذف

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