تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

ضبط غلاف Reels عبر واجهة Instagram API

تحدد Instagram API غلاف Reel بإحدى طريقتين عند إنشاء الحاوية: يشير cover_url إلى صورة JPEG تُستخدم غلافًا في علامة تبويب Reels، أو يختار thumb_offset إطارًا من الفيديو بالمليثانية منذ البداية. وإذا لم يُرسل أي منهما، يُستخدم الإطار الأول، وعند إرسال الاثنين يتقدم cover_url.

ينشر easyCoexistence مقاطع Reels عبر publish_instagram_post من Claude أو ChatGPT أو من كودك الخاص.

8 MB

أكبر صورة غلاف لـReels؛ يجب أن تكون JPEG، وتُحوَّل المساحات اللونية الأخرى إلى sRGB.

9:16

الشكل الذي توصي به Meta للغلاف؛ الأشكال الأخرى تُقص إلى مستطيل 9:16 الأوسط.

1:1

المربع الأوسط الذي تقصه Meta من الغلاف عند مشاركة Reel إلى Feed.

0 ms

القيمة الافتراضية لـthumb_offset، التي تجعل الإطار الأول للفيديو هو الصورة المصغرة.

2207057

رمز الخطأ الفرعي لـthumb_offset إذا كانت القيمة أقل من 0 أو مساوية لمدة الفيديو أو أطول منها.

كيف أضبط غلاف Reel؟

على حاوية Reel. يقبل الطلب POST /<IG_ID>/media مع media_type REELS و video_url إما cover_url، وهو عنوان URL عام لصورة تجلبها Meta وتستخدمها غلافًا لعلامة تبويب Reels، أو thumb_offset، وهو موضع الإطار المطلوب بالمليثانية. ينتمي الغلاف إلى الحاوية، لذلك يُختار قبل نشر Reel.

A Reel container with its own cover
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "media_type": "REELS",
  "video_url": "https://example.com/reel.mp4",
  "caption": "<CAPTION>",
  "cover_url": "https://example.com/cover.jpg"
}

ما المواصفات التي يجب أن تستوفيها صورة الغلاف؟

مواصفات Meta لصورة غلاف Reels، ويجب أن تستوفيها الصورة الموجودة في cover_url:

  • الصيغة: JPEG.
  • حجم الملف: حتى 8 ميغابايت.
  • المساحة اللونية: sRGB؛ والصور بمساحات لونية أخرى تُحوَّل.
  • نسبة العرض إلى الارتفاع: يُوصى بـ 9:16، لتجنب القص أو المساحات الفارغة.
  • الموقع: خادم عام، لأن Meta تجلب الصورة من العنوان بنفسها.

كيف يُقص الغلاف؟

من المنتصف. عندما لا تكون الصورة بنسبة 9:16، تقصها Meta وتستخدم مستطيل 9:16 الأوسط غلافًا للـReel، وعند مشاركة Reel إلى Feed يصبح المربع 1:1 الأوسط غلاف منشور Feed. إبقاء الوجوه والنصوص قرب المركز يضمن ظهورها في القصّين معًا.

كيف يعمل thumb_offset؟

يحدد لحظة في الفيديو بالمليثانية، وإطارها يصبح الصورة المصغرة، والقيمة الافتراضية 0، أي الإطار الأول. يجب أن تكون القيمة 0 أو أكبر، وأقل من مدة الفيديو، وإلا يفشل الطلب برمز 1 ورمز فرعي 2207057. ينطبق thumb_offset على حاويات الفيديو أيضًا، وإذا كان لدى Reel غلاف cover_url أيضًا فإن Meta تتجاهل thumb_offset.

هل يمكن قراءة الغلاف أو تغييره لاحقًا؟

يمكن قراءته: يُظهر Reel المنشور media_type بقيمة VIDEO، ويعيد حقل thumbnail_url صورة مصغرة للوسائط. أما تغييره فأمر آخر، لأن التحديث الوحيد الموثق من Meta للوسائط المنشورة هو تفعيل التعليقات أو تعطيلها، لذلك يُحسم الغلاف عند إنشاء الحاوية.

الأخطاء الشائعة

  • إرسال cover_url وthumb_offset معًا وتوقع الإطار. تستخدم Meta cover_url وتتجاهل thumb_offset.
  • تمرير thumb_offset بالثواني. إنه يُحسب بالمليثانية، والقيمة التي تساوي مدة الفيديو أو تتجاوزها تفشل برمز فرعي 2207057.
  • رفع غلاف بصيغة PNG. يجب أن يكون غلاف Reels بصيغة JPEG وبحجم يصل إلى 8 ميغابايت.
  • وضع الموضوع عند حافة الغلاف. تحتفظ Meta بالمنتصف 9:16 من الصورة، وبالمربع الأوسط فقط في Feed.
إنجاز ذلك باستخدام EasyCoexistence

لا تقبل الأداة cover_url ولا thumb_offset، لذلك يخرج الـ Reel بالإطار الذي يختاره Instagram، ويُختار غلاف آخر داخل تطبيق Instagram. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية لمدة 3 أيام.

الأسئلة الشائعة

هل يمكنني رفع غلاف مخصص لـReel عبر API؟

نعم. مرّر cover_url مع العنوان العام لصورة JPEG بحجم يصل إلى 8 ميغابايت عند إنشاء حاوية Reel.

هل يجب أن يكون غلاف Reel بمساحة sRGB؟

يُفضَّل ذلك. تطلب مواصفات Meta مساحة sRGB وتحوّل الصور بمساحات لونية أخرى، ويجب أن يكون الغلاف بصيغة JPEG وبحجم يصل إلى 8 ميغابايت.

ماذا يعني الخطأ 2207057 في Reel على Instagram؟

يعني أن thumb_offset خارج النطاق ضمن الرمز 1: يجب أن تكون القيمة 0 أو أكبر وأقل من مدة الفيديو، محسوبةً بالمليثانية، فالثانية الخامسة تُكتب 5000.

ماذا لو أرسلت cover_url وthumb_offset معًا؟

تستخدم Meta صورة cover_url وتتجاهل thumb_offset.

تابع القراءة

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في