واجهة API تشكيلة مجموعة المنتجات

يمكنك استخدام واجهة API هذه لإنشاء التشكيلات المستخدمة في المتاجر وإضافة بيانات التعريف إلى مجموعة منتجات، مثل صورة غلاف ووصف. وتصبح مجموعات المنتجات هذه جاهزة بعد ذلك لاستخدامها كتشكيلات في مدير المعاملات التجارية لتخصيص متجر Facebook أو Instagram (بخلاف ذلك، يتم إنشاء التشكيلات يدويًا). يمكنك أيضًا نشر مجموعات المنتجات الجاهزة مباشرةً من خلال توفير معرفات المتجر. ويمكن الحصول على معرفات المتجر من خلال استخدام واجهات API المعاملات التجارية.

تعرف على المزيد حول كيفية إنشاء تشكيلة في مدير المعاملات التجارية، مركز مساعدة الأعمال.

POST (إنشاء/تحديث واجهة API)

تبقى خطوات إنشاء وتحديث مجموعات المنتجات كما هي. ومع ذلك، توجد بعض الحقول الاختيارية الجديدة التي يجب ملاحظتها:

حقول بيانات التعريف

حقول النشر في المتاجر

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

المثال - حمولة البيانات

{ 
    "name": "Best sellers",
    "filter": {
      "retailer_id": {
        "is_any": [
          "pid1",
          "pid2"
        ]
      } 
    },
    "metadata": {
      "cover_image_url": "https://foo.com/image.jpg" (https://foo.com/image.jpg%E2%80%9D),
      "external_url": "https://foo.com/best-sellers",
      "description":"Our best selling products"
    }
  "publish_to_shops": [{"shop_id": "shop_id1"}, {"shop_id": "shop_id2"}]
}

إنشاء مجموعة منتجات

إنشاء مجموعة منتجات من خلال بيانات تعريف التشكيلة التي تطابق معرفات منتجات معينة:

curl \
  -F "name=Best Sellers" \
  -F "filter={'retailer_id': {'is_any': ['pid1', 'pid2']}}" 
  -F "metadata={'cover_image_url':'https://foo.com/image.jpg', 'external_url':'https://foo.com/best-sellers', 'description':'Our best selling products'}" \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/API_VERSION/PRODUCT_CATALOG_ID/product_sets

تحديث مجموعة منتجات

تحديث مجموعة منتجات موجودة من خلال بيانات تعريف التشكيلة ونشرها في المتاجر:

curl \
  -F "name=Updated Best Sellers" \
  -F "metadata={'cover_image_url':'https://foo.com/image_updated.jpg', 'external_url':'https://foo.com/best-sellers-updated', 'description':'Our updated best selling products'}" \
  -F "publish_to_shops=[{'shop_id':'shop_id1'}, {'shop_id':'shop_id2'}]"
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/API_VERSION/PRODUCT_SET_ID

GET (واجهة API القراءة)

في العقدة GET، يعمل الحقل live_metadata على إرجاع بيانات التعريف المنشورة والمباشرة في مجموعة منتجات معينة، بينما يعمل الحقل latest_metadata على إرجاع بيانات التعريف التي تم إرسالها مؤخرًا إلى واجهة API. وقد تختلف هذه الحقول إذا، على سبيل المثال، تم تغيير صورة عند التحديث وتم رفضها لأسباب تتعلق بالدمج.

حقول بيانات التعريف

المثال - قراءة مجموعة منتجات لمعرفة بيانات التعريف التي يتم نشرها:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_SET_ID>/?fields=id,name,latest_metadata{cover_image_url, description, review_status},live_metadata{cover_image_url, description, review_status}

الاستجابة:

{ 
    "id": 1234567890,
    "name": "Best sellers",
    "latest_metadata": {
        "cover_image_url": "https://foo.com/some_new_image.jpg" (https://foo.com/image.jpg%E2%80%9D),
        "description":"Our best selling products",
        "integrity_review_status": "REJECTED"
    },
    "live_metadata": {
        "cover_image_url": "https://foo.com/some_good_image.jpg", 
        "description":"Our best selling products",
        "integrity_review_status": "APPROVED"
    }
}

الأسئلة المتكررة

س: ما الحد الأدنى المقبول لنسبة العرض إلى الارتفاع لصورة الغلاف؟

ج: يجب أن تكون الصور على الأقل 600×600 (على الرغم من عدم توفر إمكانية الاقتصاص بهذه النسبة). وإذا تم تحميل صورة بنسبة عرض إلى ارتفاع 800×800 أو أكبر، فسيتم تحديد نسبة عرض إلى ارتفاع بأبعاد مربعة كخيار افتراضي. للحصول على أفضل النتائج، نوصي باستخدام نسبة عرض إلى ارتفاع تبلغ 1080×1080.

س: ما الحد الأقصى لحجم ملف صورة الغلاف؟

ج: الحجم الأقصى للملف هو 8 ميجابايت.

س: ما تنسيقات الملفات المدعومة لصور الغلاف؟

ج: يتم دعم JPG وPNG.

س: هل توجد تقييدات على طول الوصف؟

ج: لا يوجد حد أدنى لطول الوصف. علمًا بأن الحد الأقصى للطول هو 200 حرف.

س: كيف يمكنني إلغاء نشر تشكيلة (مجموعة منتجات) من المتاجر؟

ج: يمكنك استخدام واجهة API التحديث وإزالة الحقل shop_id من قائمة publish_to_shop حيثما تم نشر التشكيلة سابقًا. وإذا تم توفير مصفوفة فارغة ([])، فلن يتم إلغاء نشر مجموعة المنتجات من كل المتاجر.

معرفة المزيد

• إنشاء تشكيلة في مدير المعاملات التجارية، مركز مساعدة الأعمال
• مجموعات المنتجات، مرجع MAPI