يسمح لك عنصر ربط المقالات والمنشورات في كتالوج المنتجات بإدراج عناصر المقالات والمنشورات (الكتب الإلكترونية، وكتب التعليق الصوتي، والمجلات، والصحف، وغيرها من المحتوى المكتوب) وإنشائها في كتالوج المنتجات.
لاستخدام واجهة API هذه، يحتاج تطبيقك إلى الإذن التالي:
catalog_managementلعرض عناصر المقالات والمنشورات في كتالوج، أرسل طلب GET:
GET /v25.0/{product-catalog-id}/articles_and_publications HTTP/1.1
Host: graph.facebook.com| المعلمة | النوع | الوصف |
|---|---|---|
| string (سلسلة) | اختياري. قاعدة فلتر WCA بتشفير JSON لفلترة المقالات والمنشورات. على سبيل المثال: |
| boolean (قيمة منطقية) | اختياري. عندما تكون القيمة |
| integer (عدد صحيح) | اختياري. الحد الأقصى لعدد العناصر التي سيتم إرجاعها لكل صفحة. |
| string (سلسلة) | اختياري. مؤشر للتنقل إلى الخلف بين الصفحات. |
| string (سلسلة) | اختياري. مؤشر للتنقل إلى الأمام بين الصفحات. |
ستؤدي القراءة من خلال عنصر الربط هذا إلى إرجاع نتيجة بتنسيق JSON:
{
"data": [],
"paging": {},
"summary": {}
}dataقائمة بعُقد المقالات والمنشورات. راجع مرجع المقالات والمنشورات للحصول على قائمة كاملة بالحقول.
pagingلمزيد من التفاصيل حول تقسيم الصفحات، راجع دليل واجهة Graph API.
summaryالمعلومات المجمَّعة حول عنصر الربط، مثل الأعداد. حدد summary=true كمعلمة استعلام لتضمين ذلك في الاستجابة.
| الحقل | النوع | الوصف |
|---|---|---|
| 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"
}لا يمكنك إجراء هذه العملية على هذه العقدة. لتحديث عناصر المقالات أو المنشورات الفردية، استخدم العقدة المقالات والمنشورات.
لا يمكنك إجراء هذه العملية على هذه العقدة. لحذف عناصر المقالات أو المنشورات الفردية، استخدم العقدة المقالات والمنشورات.