حالة حاوية وسائط Instagram: الرموز ودورة الحياة
تنشر واجهة API الخاصة بـ Instagram عبر حاويات الوسائط (media container)، وتُبلغ كل حاوية عن status_code: IN_PROGRESS أثناء وجودها في عملية النشر، و FINISHED عند جهوزيتها، و PUBLISHED بعد أن تصبح منشورة، و ERROR إذا تعذّر إكمالها، و EXPIRED إذا مرت 24 ساعة دون نشرها. توصي Meta بالتحقق مرة كل دقيقة، ولمدة لا تتجاوز 5 دقائق.
تُدير easyCoexistence دورة الحاوية داخل publish_instagram_post: تُنشئ الحاوية، وتنتظر انتهاء Instagram من المعالجة ثم تنشر، وبينما يُعالج الفيديو تُكمل النشر من تلقاء نفسها.
القيم التي قد يأخذها status_code: IN_PROGRESS، FINISHED، PUBLISHED، ERROR وEXPIRED.
المدة التي يمكن أن تنتظرها الحاوية دون نشر قبل أن تتحول حالتها إلى EXPIRED.
الفاصل الزمني المقترح من Meta بين فحوص الحالة، بحد أقصى 5 دقائق.
عدد الحاويات التي يمكن لحساب Instagram إنشاؤها خلال 24 ساعة متحركة.
الرمز الفرعي للخطأ ضمن الرمز 9007 عند نشر حاوية غير جاهزة بعد.
ما هي حاوية الوسائط؟
الكائن الذي يُنشر منه المنشور. يُنشئ POST /<IG_ID>/media حاوية من رابط صورة أو فيديو، فتجلب Meta الوسائط وتُجهزها، ثم يحوّلها POST /<IG_ID>/media_publish، مع تمرير معرّف الحاوية في creation_id، إلى منشور. وتضيف المنشورات من نوع عرض الشرائح (carousel) مستوى إضافيًا: حاوية لكل عنصر، ثم حاوية CAROUSEL تسرد هذه العناصر بوصفها عناصر فرعية.
ماذا تعني كل قيمة من قيم الحالة؟
يُرجع GET /<IG_CONTAINER_ID>?fields=status_code واحدة من خمس قيم، ولكل منها خطوتها التالية:
IN_PROGRESS: ما زالت الحاوية في عملية النشر؛ انتظر ثم تحقق مرة أخرى.- FINISHED: الحاوية ووسائطها جاهزة؛ انشرها.
- PUBLISHED: الوسائط منشورة بالفعل؛ لم يبقَ شيء لنشره.
- ERROR: لم تكتمل الحاوية عملية النشر؛ يحتوي حقل status على رمز فرعي للخطأ يوضح السبب، ويلزم إنشاء حاوية جديدة.
- EXPIRED: لم تُنشر خلال 24 ساعة؛ أنشئ حاوية جديدة.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}كم مرة يجب التحقق من الحالة؟
توصي Meta بمرة كل دقيقة، ولمدة لا تتجاوز 5 دقائق. ويكون التحقق أهم ما يكون في الفيديو، إذ تنص Meta على أن رفع الفيديو غير متزامن: فاستلام معرّف الحاوية لا يضمن نجاح الرفع، وما يؤكد ذلك هو status_code بقيمة FINISHED.
ماذا يحدث إذا نشرت مبكرًا؟
يفشل media_publish بالرمز 9007 والرمز الفرعي 2207027: الوسائط غير جاهزة للنشر. ولا يحتاج الطلب إلى أي تعديل؛ تحقق من الحالة وانشر عندما تصبح FINISHED. أما الرمز 24 مع الرمز الفرعي 2207008 فمختلف، وهو يعني أن الحاوية غير موجودة أو انتهت صلاحيتها، وتقترح Meta إعادة المحاولة مرة أو مرتين خلال 30 ثانية إلى دقيقتين قبل إنشاء حاوية جديدة.
كم تدوم الحاوية؟
24 ساعة. الحاوية التي لا تُنشر خلال هذه المدة تصبح EXPIRED ولا يمكن نشرها بعد ذلك، ويطلب الرمز -2 مع الرمز الفرعي 2207020، أي انتهاء صلاحية الوسائط، إنشاء حاوية جديدة أيضًا. ويمكن للحساب إنشاء 400 حاوية خلال 24 ساعة متحركة، وهذا يترك مجالًا لإعادة الإنشاء بعد أي فشل.
ماذا تُبلغ الحاوية أيضًا؟
حقلان إضافيان، وملاحظة تصدر عن النشر. يحتوي status على رمز فرعي للخطأ كلما كانت قيمة status_code هي ERROR. ويوضح copyright_check_status، في حالة الفيديو، ما إذا كان فحص حقوق النشر من Meta قد أُجري وما إذا وجد تطابقات. وبعد النشر، قد يُرجع media_publish القيم config_issue أو CAPTION_NOT_ATTACHED أو USER_TAGGING_FAILURE، عندما يُنشر المنشور دون وصفه أو دون وسوم المستخدمين.
الأخطاء الشائعة
- اعتبار معرّف الحاوية رفعًا مكتملًا. رفع الفيديو غير متزامن، ولا يؤكد جاهزية الوسائط إلا status_code بقيمة FINISHED.
- النشر أثناء ظهور IN_PROGRESS. يفشل الطلب بالرمز الفرعي 2207027 حتى تصبح القيمة FINISHED.
- الاحتفاظ بالحاوية لأكثر من يوم. بعد 24 ساعة دون نشر تصبح EXPIRED، ولا يُنشر إلا بحاوية جديدة.
- قراءة status_code وحده عند الفشل. عندما تكون القيمة ERROR، يحمل حقل status الرمز الفرعي الذي يحدد السبب.
ويحصل Claude أو ChatGPT أو كودك الخاص على معرّف الوسائط المنشورة، أو على حالة المعالجة إلى أن تُكملها easyCoexistence. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
ماذا يعني IN_PROGRESS على حاوية Instagram؟
لا تزال Meta تُجهّز الوسائط. انتظر ثم تحقق مرة أخرى، لأن النشر قبل أن تصبح الحالة FINISHED يفشل بالرمز 9007.
كم عدد حاويات الوسائط التي يمكن لحساب Instagram إنشاؤها؟
400 خلال 24 ساعة متحركة، وهذا يترك مجالًا لإعادة إنشاء حاوية بعد أي فشل.
ماذا يعني config_issue بعد النشر؟
نجح media_publish، لكن المنشور ظهر دون وصفه CAPTION_NOT_ATTACHED، أو دون وسوم المستخدمين USER_TAGGING_FAILURE.
لماذا انتهت حاويتي بالحالة ERROR؟
لم تكتمل عملية النشر. يحمل حقل status رمزًا فرعيًا للخطأ يوضح السبب؛ عالج ذلك السبب ثم أنشئ حاوية جديدة.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في