‏كتالوج المنتجات‏

إرسال مجموعة عناصر مُطوّعة محليًا

لإرسال تحديثات التطويع المحلي، استخدم نقطة النهاية /{catalog_id}/localized_items_batch.

لإنشاء المنتجات المُطوّعة محليًا أو تحديثها أو حذفها في الكتالوج لديك، يمكنك إجراء استدعاء HTTP POST إلى:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/localized_items_batch?requests=<REQUESTS>

المعلمات

المعلمة النوع الوصف

item_type

enum (تعداد)

نوع العناصر الموجودة في الطلب. القيم المدعومة: DESTINATION وFLIGHT وHOME_LISTING وHOTEL وHOTEL_ROOM وPRODUCT_ITEM وVEHICLE وVEHICLE OFFER.

requests

object (كائن)

كائن JSON يحتوي على كل الطلبات.

requests.data

object (كائن)

كائن JSON يحتوي على الحقول والقيم لمنتج ما.

عندما يكون الأسلوب CREATE، يجب أن يحتوي هذا الكائن على حقول مُطوّعة محليًا لنوع item_type المحدد.

requests.method

string (سلسلة)

CREATE وUPDATE وDELETE

requests.localization

object (كائن)

كائن JSON يحتوي على بيانات تطويع المحلي التي تريد تطبيقها على عنصر الكتالوج المحدد. يجب أن يحتوي هذا الكائن على هذه الحقول:

  • type — القيم المدعومة: LANGUAGE أو COUNTRY أو LANGUAGE_AND_COUNTRY
  • value — يمكن أن تكون أي لغة صالحة أو رمز بلد، استنادًا إلى النوع المحدد. لاحظ أنه بالنسبة إلى LANGUAGE_AND_COUNTRY، يجب فصل القيم من خلال الحرف "|"، على سبيل المثال en_XX|US. راجع قائمة اللغات وأكواد البلدان هنا.

يحتوي إعداد الكتالوج المُطوّع محليًا على قوائم اللغات والبلدان المدعومة لعمليات تجاوز الكتالوج، وأمثلة على أنواع وقيم عمليات التجاوز عند التطويع محليًا من خلال LANGUAGE أو COUNTRY أو LANGUAGE_AND_COUNTRY. راجع الحقول المدعومة — الكتالوجات المُطوّعة محليًا للحصول على قائمة حقول الكتالوج المدعومة.

التقييدات

  • بإمكان المعلمة requests أن تحتوي على ما يصل إلى 1,000 عنصر.
  • بالنسبة لكل كتالوج، يمكنك إجراء عدد من الاستدعاءات كل ساعة يتم تحديدها بواسطة معادلة تجميع كتالوج تقييد معدلات الاستدعاء لحالة استخدام النشاط التجاري. إذا لم يكن ذلك كافيًا، فيُرجى التواصل معنا.

الحقول المدعومة

راجع قائمة الحقول المدعومة وأوصافها المقابلة لكل حقل، لنقطة النهاية /{catalog_id}/localized_items_batch:

راجع أيضًا

مثال

عينة من الطلب

POST /{catalog_id}/*localized_items_batch*
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
       "data": {
         "id": "retailer-2",
         "title": "C'est un tshirt",
         "description": "Le t-shirt a un joli motif",
         "link": "http://www.fr.example.com/t-shirts/1.png"
       }
    },
    {
      "method": "CREATE",
      "localization": {
        "type": "COUNTRY",
         "value": "FR"
      },
       "data": {
         "id": "retailer-2",
         "availability": "in stock",
         "price": "9.99 EUR"
       }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
      "data": {
        "id": "retailer-3",
        "availability": "out of stock",
        "link": "http://www.fr.example.com/t-shirts/2.png"
      }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-3",
        "price": "19.99 USD"
      }
    },
    {
      "method": "DELETE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-4"
      }
    }
  ]
}

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

"handles": ["AczBWxwCxXv4s3xQpm0JwXBlhs-IPGatrWmDRBmc1wTYrV5JvtkuQRT_FOCmKZGmHvotvvX8UtQnwEgg16wTx14cqPYzWVzmxZiaZDLgMUmjSA"]

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

يمكنك استخدام الحقل applink لتحديد معلومات رابط لموضع معين؛ حيث يعمل بطريقة تشبه الروابط لمواضع معينة. يمكنك تقديم معلومات رابط لموضع معين بتنسيق JSON كما هو موضح أدناه.

"applink" : {"ios": [{"url":"example-ios://electronic","app_store_id":42,"app_name":"Electronic Example iOS"}],"iphone": [{"url":"example-iphone://electronic","app_store_id":43,"app_name":"Electronic Example iPhone"}],"ipad": [{"url":"example-ipad://electronic","app_store_id":44,"app_name":"Electronic Example iPad"}],"android": [{"url":"example-android://electronic","package":"com.electronic","class":"com.electronic.Example","app_name":"Electronic Example Android",}],"windows_phone": [{"url":"example-windows://electronic","app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0","app_name":"Electronic Example Windows"}]}

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

'data\[applink\]\[android\]' هي مصفوفة بقيمة واحدة فقط يتم تحديدها أسفلها. وهذه هي الحالة نفسها لأنواع التطبيقات الأخرى.

لا ندعم روابط iOS العامة.

لتطويع أي حقول لرابط التطبيق محليًا، يجب توفير كل الحقول. تعرف على المزيد حول الروابط لمواضع معينة للمنتجات.

معرفة المزيد