منشورات الكاروسيل على Instagram عبر واجهة برمجة التطبيقات (API)
تنشر API الخاصة بـ Instagram الكاروسيل كمنشور واحد يضم حتى 20 صورة وفيديو وفق دليل النشر لدى Meta، رغم أن مرجع الأخطاء ما زال يذكر 10. يحصل كل عنصر على حاوية خاصة به مع ضبط is_carousel_item على true، ثم تُدرج حاوية CAROUSEL هذه العناصر كعناصر فرعية وتحمل الوصف. ونشر هذه الحاوية ينشر العناصر معًا، ويُحسب ذلك منشورًا واحدًا ضمن الحد المسموح به وهو 100 منشور عبر API خلال 24 ساعة.
يتيح easyCoexistence نشر كاروسيلات من 2 إلى 10 صور وفيديوهات باستخدام publish_instagram_post من Claude أو ChatGPT أو من كودك الخاص: نداء واحد بالعناصر والوصف ينشر المنشور، ويكتمل من تلقاء نفسه أثناء معالجة فيديو ما.
الصور والفيديوهات التي يمكن أن يضمها الكاروسيل وفق دليل النشر لدى Meta ومعامل children.
الرمز الفرعي ضمن رمز الخطأ 100، الذي ما زالت رسالته تذكر أن الكاروسيل يحتاج إلى من 2 إلى 10 عناصر.
ما يُحسب به الكاروسيل ضمن حد 100 منشور عبر API خلال 24 ساعة.
القص الافتراضي لصور الكاروسيل، إذ تتبع كلها نسبة عرض إلى ارتفاع الصورة الأولى.
التحليلات التي تعيدها Meta للصور والفيديوهات الفردية داخل الكاروسيل.
كيف يُنشر الكاروسيل؟
على ثلاث مراحل، كلها عبر POST /<IG_ID>/media واستدعاء واحد للنشر.
- العناصر: أنشئ حاوية لكل صورة (
image_url) أو فيديو (media_typeبقيمة VIDEO وvideo_url)، مع ضبطis_carousel_itemعلى true ودون وصف. - الكاروسيل: أنشئ حاوية بقيمة CAROUSEL في
media_type، مع children تُضبط على معرّفات حاويات العناصر مفصولةً بفواصل، والوصف. - النشر: أرسل POST /<
IG_ID>/media_publishمعcreation_idيساوي معرّف حاوية الكاروسيل.
كم عدد العناصر التي يمكن أن يضمها الكاروسيل؟
حتى 20. يضع دليل النشر لدى Meta ومعامل children في POST /<IG_ID>/media الحد عند 20 صورة أو فيديو أو مزيج منهما. أما مرجع الأخطاء فما زال يعرض الصيغة القديمة: رسالة الرمز 100 والرمز الفرعي 2207028 تقول إن الكاروسيل يحتاج إلى عنصرين على الأقل ولا يتجاوز 10 عناصر، لذلك فإن العدد من 2 إلى 10 هو العدد الذي تقبله كل أجزاء وثائق Meta. ويمكن أن تكون العناصر صورًا أو فيديوهات، لكن لا يمكن أن تكون Reels، فعنصر الكاروسيل هو دائمًا حاوية صورة أو فيديو.
كيف تُقص صور الكاروسيل؟
إلى الأولى. تُقص كل صورة في الكاروسيل وفق نسبة عرض إلى ارتفاع الصورة الأولى، والافتراضي مربع 1:1. ولا تزال كل صورة تخضع للقواعد المعتادة: JPEG، وحجم يصل إلى 8 MB، ونسبة بين 4:5 و1.91:1. ضع الصورة التي تريد شكلها أولًا، أو اجعل كل الصور بالشكل نفسه قبل النشر.
ما الذي ينتمي إلى الكاروسيل وما الذي ينتمي إلى كل عنصر؟
تعيش معظم إعدادات المنشور على حاوية الكاروسيل وليس على العناصر.
- الوصف: على حاوية الكاروسيل فقط؛ لا تقبل العناصر وصفًا.
- الموقع: على حاوية الكاروسيل فقط.
- وسم المحتوى المولَّد بالذكاء الاصطناعي: يوضع
is_ai_generatedعلى حاوية الكاروسيل، وضبطه على عنصر يعيد خطأ. - النص البديل: مدعوم في عناصر الصور، حتى 1,000 حرف لكل عنصر.
كيف يُقرأ الكاروسيل بعد النشر؟
ككائن وسائط واحد بقيمة media_type تساوي CAROUSEL_ALBUM. يعرض GET /<IG_MEDIA_ID>/children الصور والفيديوهات الداخلة فيه، مع أن بعض الحقول، مثل permalink، لا تعمل على العناصر الفرعية. ولا تشمل عدادات التعليقات والإعجابات للكاروسيل عناصره الفرعية، ولا تعيد Meta تحليلات للعناصر الفردية، بل للمنشور نفسه.
كيف يُحسب الكاروسيل ضمن الحدود؟
كمنشور واحد. يمكن للحساب نشر 100 منشور عبر API خلال 24 ساعة متحركة، ويستهلك الكاروسيل واحدًا منها مهما بلغ عدد عناصره. لكن كل عنصر يبقى حاوية، ويمكن للحساب إنشاء 400 حاوية خلال 24 ساعة متحركة، لذا فإن سلسلة من كاروسيلات من عشرة عناصر تبلغ هذا السقف قبل سقف النشر.
الأخطاء الشائعة
- وضع الوصف على عنصر. لا تُدعم الأوصاف في عناصر الكاروسيل؛ اضبطه مرة واحدة على حاوية الكاروسيل.
- إضافة Reel كعنصر. عناصر الكاروسيل حاويات صور أو فيديو، ولا يمكن أن يظهر Reel داخل الكاروسيل.
- خلط صور عمودية وأفقية دون التحقق من الأولى. تأخذ كل صورة نسبة عرض إلى ارتفاع الصورة الأولى.
- توقع تحليلات لكل شريحة. لا تعيد Meta أي تحليلات للوسائط داخل الكاروسيل، بل للمنشور فقط.
ويمكن جدولة الكاروسيلات من قائمة انتظارها الخاصة أيضًا. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكن جدولة كاروسيل Instagram عبر API؟
نعم، عبر قائمة انتظار، لأن Meta تنشر الكاروسيل عند نشر حاويته. يقبل publish_instagram_post في easyCoexistence المعامل scheduled_at، من دقيقة واحدة إلى 90 يومًا مقدمًا، للكاروسيلات من 2 إلى 10 عناصر.
هل يمكن وسم الكاروسيل بأنه مولَّد بالذكاء الاصطناعي؟
نعم، عبر is_ai_generated على حاوية الكاروسيل. ضبطه على عنصر يعيد خطأ.
هل يمكن أن يتضمن الكاروسيل Reel؟
لا. يُنشر Reel دائمًا منفردًا، وعناصر الكاروسيل حاويات صور أو فيديو عادية.
لماذا يفشل الكاروسيل برمز الخطأ 2207028؟
تقول رسالة Meta لهذا الرمز إن الكاروسيل يحتاج إلى عنصرين على الأقل ولا يتجاوز 10 عناصر. ويُرضي العدد من 2 إلى 10 هذه الرسالة وحد 20 في دليل النشر معًا، لذا عدّل العناصر ثم أنشئ حاوية الكاروسيل من جديد.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في