البحث عن منتج في كتالوج مستخدم IG

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

الإنشاء

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

القراءة

GET /{ig-user-id}/catalog_product_search

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

التقييدات

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

المتطلبات

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

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

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

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

المفتاح	العنصر النائب	القيمة
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`catalog_id`	`{catalog-id}`	مطلوب. معرف الكتالوج المطلوب البحث عنه.
`q`	`{q}`	السلسلة المطلوب البحث عنها في كل اسم منتج أو رقم وحدة إدارة المخزون (يمكن إضافة أرقام وحدة إدارة المخزون في العمود معرف المحتوى في واجهة إدارة الكتالوجات). وإذا لم يتم تحديد سلسلة، فسيتم إرجاع كل المنتجات المؤهلة للإشارة.

الاستجابة

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

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

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

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

مثال على cURL

الطلب

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

التحديث

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

الحذف

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