استخدم هذا الدليل لتحميل قائمة البيانات وجدولتها.
لتحميل قائمة البيانات، تحتاج إلى الإذن catalog_management
. راجع API التسويق، الأذونات. بعد إنشاء الكتالوج، استخدم catalog id
لإنشاء قائمة بيانات المنتج وجدولتها:
curl -X POST \
-F 'name="Test Feed"' \
-F 'schedule={
"interval": "DAILY",
"url": "http://www.example.com/sample_feed.tsv",
"hour": "22"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{product-catalog-id}/product_feeds
تمكنك المعلمة schedule
من جدولة تحميل قائمة البيانات. تتضمن الخيارات interval
وurl
وhour
. كما يمكن أن تتضمن أيضًا day_of_week
وminute
وusername
وpassword
.
ملاحظة: بالنسبة إلى username
وpassword
، فإننا ندعم المصادقة الأساسية على HTTP وFTP.
مثال - جدولة تحميل قائمة البيانات
schedule: {"day_of_week":"FRIDAY","hour":17,"interval_count":1,"interval":"DAILY","minute":42,"next_scheduled_upload_time":"","password":pwd123,"status":"active","timezone":"Atlantic/Canary","url":"https://www.abc.com","username":aname}
يمكنك تحديث بيانات عنصر فردي بشكل فوري. يمكنك تضمين الحقول التي تم تحديثها في HTTP POST
، حيث يكون retailer_id
هو معرف العنصر من قائمة البيانات. يجب أن يكون بتشفير base64url.
https://graph.facebook.com/catalog:{CATALOG_ID}:{base64urlencode(retailer_id)}
راجع الحقول القابلة للتغير في المنتجات، المرجع.
لا توفر قوائم بيانات العناصر من خلال تحديثات العنصر الفردي أو لا تحاول إنشائها أو حذفها من خلال API. يمكن أن يؤدي هذا إلى تعطيل أي تحديثات أو عمليات حذف للعناصر التي أنشأتها باستخدام API حيث إننا لا نتتبعها من خلال قائمة البيانات.
لا تدعم قوائم البيانات المجدولة عمليات التحميل بشكل متكرر أكثر من مرة واحدة في الساعة. إذا كنت تحتاج إلى تحديث المخزون بشكل أسرع، فنوصي باستخدام API التحميل المباشر.
إذا كنت تستخدم API لإنشاء قوائم البيانات أو إدارتها، فستحتاج إلى إرسال طلب API إلينا بتفاصيل جدول التحديث الذي تريد إنشاءه:
curl \ -F 'name=Test Feed' \ -F 'update_schedule={ "interval": "HOURLY", "url": "http:\/\/www.example.com\/sample_feed_updates.tsv", "hour": 22 }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds
نحصل على قوائم بيانات العناصر من النظام حسب الجدول الذي تحدده. يتوفر نوعان من الجداول التي يمكنك تحديدها:
update_schedule
- تنشئ عمليات التحميل عناصر جديدة أو تعمل على تحديث عناصر موجودة من خلال المعلومات التي قمت بتوفيرها في ملف قائمة البيانات.schedule
- تؤدي عمليات التحميل إلى عملية تحديث كاملة في قائمة البيانات. نحذف العناصر غير الموجودة في الملف ونعمل على تحديث العناصر الموجودة وننشئ عناصر جديدة. يمكنك استخدام أحد الجدولين أو كليهما، استنادًا إلى احتياجاتك.على سبيل المثال: update_schedule
بمعدل التكرار HOURLY
واستبدل schedule
بمعدل التكرار DAILY
.
نوصي بإعداد update_schedule
من خلال البيانات المتغيرة فقط في ملف قائمة البيانات لمعالجة أسرع لقائمة البيانات. يُعد هذا أفضل بشكل خاص لمبيعات العطلات وتحديثات الأسعار والتوفر بشكل أسرع. يوصى أيضًا بتمييز العناصر على أنها "غير متوفرة" بدلاً من حذفها من قائمة البيانات حتى نتمكن من إعادة استهداف المستخدم بعناصر مماثلة متوفرة.
curl \ -F 'name=Test Feed' \ -F 'schedule={ "interval": "DAILY", "url": "http:\/\/www.example.com\/sample_feed.tsv" }' \ -F 'update_schedule={ "interval": "HOURLY", "url": "http:\/\/www.example.com\/sample_feed_updates.tsv", "hour": 22 }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds
الاستجابة:
{ "id" : {FEED_ID} }