مقالات ومنشورات كتالوج المنتجات

يسمح لك عنصر ربط المقالات والمنشورات في كتالوج المنتجات بإدراج عناصر المقالات والمنشورات (الكتب الإلكترونية، وكتب التعليق الصوتي، والمجلات، والصحف، وغيرها من المحتوى المكتوب) وإنشائها في كتالوج المنتجات.

الأذونات

لاستخدام واجهة API هذه، يحتاج تطبيقك إلى الإذن التالي:

  • catalog_management

القراءة

لعرض عناصر المقالات والمنشورات في كتالوج، أرسل طلب GET:

GET /v25.0/{product-catalog-id}/articles_and_publications HTTP/1.1
Host: graph.facebook.com

المعلمات

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

filter

string (سلسلة)

اختياري. قاعدة فلتر WCA بتشفير JSON لفلترة المقالات والمنشورات. على سبيل المثال: {"publication_category":{"eq":"Book"}}. راجع مجموعة المنتجات للحصول على قائمة كاملة بمشغلات الفلترة.

summary

boolean (قيمة منطقية)

اختياري. عندما تكون القيمة true، يتم تضمين كائن summary مع total_count في الاستجابة.

limit

integer (عدد صحيح)

اختياري. الحد الأقصى لعدد العناصر التي سيتم إرجاعها لكل صفحة.

before

string (سلسلة)

اختياري. مؤشر للتنقل إلى الخلف بين الصفحات.

after

string (سلسلة)

اختياري. مؤشر للتنقل إلى الأمام بين الصفحات.

الحقول

ستؤدي القراءة من خلال عنصر الربط هذا إلى إرجاع نتيجة بتنسيق JSON:

{
  "data": [],
  "paging": {},
  "summary": {}
}

data

قائمة بعُقد المقالات والمنشورات. راجع مرجع المقالات والمنشورات للحصول على قائمة كاملة بالحقول.

paging

لمزيد من التفاصيل حول تقسيم الصفحات، راجع دليل واجهة Graph API.

summary

المعلومات المجمَّعة حول عنصر الربط، مثل الأعداد. حدد summary=true كمعلمة استعلام لتضمين ذلك في الاستجابة.

الحقلالنوعالوصف

total_count

integer (عدد صحيح)

إجمالي عدد العناصر في الكتالوج.

الإنشاء

لإنشاء أحد عناصر المقالات أو المنشورات في كتالوج، أرسل طلب POST:

POST /v25.0/{product-catalog-id}/articles_and_publications HTTP/1.1
Host: graph.facebook.com
Content-Type: application/json

{
  "retailer_id": "pub-001",
  "name": "The Art of Modern Architecture",
  "description": "An insightful guide exploring contemporary architectural design",
  "image_url": "https://example.com/book-cover.jpg",
  "url": "https://example.com/art-of-modern-architecture",
  "publication_category": "Book",
  "author": ["Jane Smith"],
  "genre": ["Architecture", "Design"]
}

المعلمات

الحقول التالية مطلوبة: retailer_id, name, description, image_url, url. كل الحقول الأخرى اختيارية.

للحصول على القائمة الكاملة للحقول المدعومة، راجع عقدة المقالات والمنشورات - الحقول.

الاستجابة

{
  "id": "1234567890"
}

التحديث

لا يمكنك إجراء هذه العملية على هذه العقدة. لتحديث عناصر المقالات أو المنشورات الفردية، استخدم العقدة المقالات والمنشورات.

الحذف

لا يمكنك إجراء هذه العملية على هذه العقدة. لحذف عناصر المقالات أو المنشورات الفردية، استخدم العقدة المقالات والمنشورات.