‏منصة Instagram‏

حاوية IG

تمثل حاوية وسائط لنشر منشور على Instagram. ويمكن الرجوع إلى دليل نشر المحتوى للتعرف على خطوات النشر الكاملة.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /{instagram-container-id}

احصل على الحقول وعناصر الربط في حاوية IG.

المتطلبات

النوعالوصف

رموز الوصول

المستخدم

الأذونات

instagram_basic
instagram_content_publish
pages_read_engagement


إذا تم منح مستخدم التطبيق دورًا في الصفحة عبر مدير الأعمال، فيلزم وجود أحد الأذونات التالية:


ads_management
business_management

بنية الطلب

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={fields}
  &access_token={access-token}

معلمات سلسلة الاستعلام

المعلمةالقيمة

access_token
مطلوبة
String (سلسلة)

رمز وصول المستخدم لمستخدم التطبيق.

fields
قائمة مفصولة بفاصلة

قائمة مفصولة بفاصلة تتضمن الحقول وعناصر الربط التي ترغب في إرجاعها. إذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

الحقول

اسم الحقلالوصف

copyright_check_status

يتم استخدامها لتحديد ما إذا كان الفيديو الذي تم تحميله ينتهك حقوق النشر. تتضمن نتائج أزواج القيم والمفاتيح ما يلي:

  • matches_found مع تعيينها على أحد ما يلي:
    • true - ينتهك الفيديو حقوق النشر
    • false - لا ينتهك الفيديو حقوق النشر
  • status مع تعيينها على أحد ما يلي:
    • completed – تم إنهاء عملية الاكتشاف
    • error – حدث خطأ أثناء عملية الاكتشاف
    • in_progress – عملية الاكتشاف مستمرة
    • not_started – لم تبدأ عملية الاكتشاف

id

معرف حاوية Instagram، يتم تمثيله في أمثلة على الرموز مثل {instagram-container-id}

status

يمثل حالة النشر. إذا كانت status_code بالقيمة ERROR، فستكون هذه القيمة الرمز الفرعي للخطأ.

status_code

يمثل حالة نشر الحاوية. القيم الممكنة:


  • EXPIRED — لم يتم نشر الحاوية في غضون 24 ساعة وانتهت صلاحيتها.
  • ERROR — فشلت الحاوية في إكمال عملية النشر.
  • FINISHED — تكون الحاوية وكائن الوسائط التابع لها جاهزين للنشر.
  • IN_PROGRESS — لا تزال الحاوية قيد عملية النشر.
  • PUBLISHED — تم نشر كائن وسائط الحاوية.

عناصر الربط

لا توجد عناصر ربط على هذه العقدة.

الاستجابة

يتوفر كائن بتنسيق لغة JSON يتضمن الحقول الافتراضية والمطلوبة.

{
  "{field}":"{value}",
  ...
}

عينة من الطلب

curl -X GET \
  'https://graph.facebook.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

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

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.