حاوية Instagram (IG)

تمثل حاوية وسائط لنشر كائن وسائط Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

الإنشاء

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

القراءة

GET <HOST_URL>/<IG_CONTAINER_ID>

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

بنية الطلب

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_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، يتم تمثيله في أمثلة من الرموز مثل <IG_CONTAINER_ID>

status

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

status_code

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


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

عناصر الربط

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

الاستجابة

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

{
  "<FIELD>":"<VALUE>",
  ...
}

مثال على الطلب

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

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

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

التحديث

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

الحذف

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