ريلز Instagram التجريبية عبر واجهة برمجة التطبيقات (API): trial_params والتخرج
تنشر واجهة برمجة التطبيقات (API) الخاصة بـ Instagram الريلز التجريبية، وهي ريلز تعرضها لغير المتابعين في البداية فقط، وذلك بإضافة trial_params إلى حاوية REELS. ويحدد graduation_strategy الطريقة التي يصل بها الريل إلى المتابعين: فالخيار MANUAL يترك الأمر لمالك الحساب في تطبيق Instagram، بينما يتخرج SS_PERFORMANCE تلقائيًا إذا حقق أداءً جيدًا. وقد دعمت Meta هذه الميزة مع Instagram Login منذ ديسمبر 2025.
ينشر easyCoexistence مقاطع Reels عبر publish_instagram_post من Claude أو ChatGPT أو من كودك الخاص، إلى المتابعين كالمعتاد: الأداة لا تقبل trial_params، لذا يُشارَك الريل التجريبي من تطبيق Instagram.
أضافت Meta الريلز التجريبية إلى Content Publishing API، لكل من Instagram Login وFacebook Login على حد سواء.
MANUAL، ويتخرج يدويًا في تطبيق Instagram، أو SS_PERFORMANCE، ويتخرج تلقائيًا إذا حقق الريل التجريبي أداءً جيدًا.
media_type الذي يجب أن تحمله الحاوية كلما كان trial_params موجودًا في الطلب.
أطول فيديو تقبله حاوية الريل؛ أقصره 3 ثوانٍ، وأكبر ملف 300 MB.
المدة التي تبقى فيها حاوية الوسائط دون نشر قبل انتهائها.
ما الريل التجريبي؟
ريل تعرضه Instagram لغير المتابعين للحساب فقط. ويتحول هذا الريل بعد تخرجه إلى ريل عادي يراه المتابعون، إما عندما يقرر مالك الحساب ذلك في تطبيق Instagram، أو تلقائيًا عندما يحقق أداءً جيدًا، وذلك حسب الاستراتيجية المحددة وقت النشر.
كيف تنشره عبر API؟
بالاستدعاءات المعتادة للريلز مع معامل إضافي واحد. أنشئ الحاوية عبر POST /<IG_ID>/media، واضبط media_type على REELS، وvideo_url، وcaption، وtrial_params مع graduation_strategy. ثم انتظر حتى تصبح قيمة status_code للحاوية FINISHED، وانشرها عبر POST /<IG_ID>/media_publish، مع تمرير معرف الحاوية كـ creation_id.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
{
"media_type": "REELS",
"video_url": "https://www.example.com/videos/reel.mp4",
"caption": "<CAPTION>",
"trial_params": { "graduation_strategy": "MANUAL" }
}أي استراتيجية تخرّج تختار؟
MANUAL عندما سيراجع شخص ما النتائج قبل أن يراها المتابعون، فيبقى الريل لغير المتابعين حتى يُخرَّج يدويًا في تطبيق Instagram. وSS_PERFORMANCE عندما يمكن ترك القرار لـ Instagram، فيتخرج الريل التجريبي تلقائيًا إذا حقق أداءً جيدًا. وgraduation_strategy إلزامي داخل trial_params، وهاتان هما قيمتاه الوحيدتان.
أي القواعد ما زالت تنطبق؟
كل قواعد الريل، لأن الريل التجريبي يُنشأ بالمعاملات نفسها مضافًا إليها trial_params:
- الفيديو: بصيغة MOV أو MP4، من 3 ثوانٍ إلى 15 دقيقة وبحجم يصل إلى 300 MB، على عنوان URL عام تستطيع Meta جلبه.
- المعالجة: تحقق من
status_codeللحاوية حتى تصبح FINISHED، مرة كل دقيقة لمدة لا تتجاوز 5 دقائق، كما تقترح Meta. - الصلاحية: الحاوية التي لا تُنشر خلال 24 ساعة تنتهي صلاحيتها ويجب إنشاؤها من جديد.
- التعليق: حتى 2,200 حرف و20 وسمًا @، مع حتى 5 هاشتاغات وفق القاعدة الحالية لـ Instagram (ما زال مرجع Meta للـ API يذكر 30).
- الكاروسيل: لا يمكن أن تظهر الريلز ضمنها.
هل تعمل مع Instagram Login؟
نعم. أعلن سجل التغييرات لدى Meta عن الريلز التجريبية لواجهة Instagram API مع Instagram Login ومع Facebook Login في 3 ديسمبر 2025، ويعرض دليل النشر الاستدعاء على graph.instagram.com. والأذونات هي زوج النشر: instagram_business_basic وinstagram_business_content_publish.
هل يمكن تخريج الريل التجريبي عبر API؟
تصف Meta طريقتين لتخرج الريل التجريبي: يدويًا في تطبيق Instagram بالنسبة لـ MANUAL، وتلقائيًا عند تحقيق أداء جيد بالنسبة لـ SS_PERFORMANCE. ولا يصف دليل النشر ولا مرجع الوسائط أي استدعاء API للتخرج، لذلك ينتهي دور API بمجرد نشر الريل التجريبي.
كيف تنشر ريلًا تجريبيًا من Claude أو ChatGPT؟
ليس عبر easyCoexistence اليوم. تنشئ publish_instagram_post حاوية الـ Reel بنفسها ولا تقبل trial_params، فتصل مقاطع Reels التي تنشرها إلى المتابعين كالمعتاد، ولا تُسلَّم رموز Instagram لاستدعاء خاص بك. شارك ريلًا تجريبيًا من تطبيق Instagram، عبر مفتاح Trial في شاشة المشاركة.
الأخطاء الشائعة
- إضافة trial_params إلى حاوية صورة أو كاروسيل أو ستوري. لا تقبله Meta إلا عندما يكون media_type بقيمة REELS.
- ترك graduation_strategy دون تحديد. وهو إلزامي داخل trial_params، بقيمة MANUAL أو SS_PERFORMANCE.
- النشر قبل اكتمال معالجة الفيديو. ينجح media_publish فقط بعد أن تصبح status_code للحاوية FINISHED.
- توقع أن يراه المتابعون الريل التجريبي عند نشره. إنه يُعرض لغير المتابعين فقط حتى يتخرج.
بسعر من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، يقل كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل تستطيع واجهة Instagram API نشر الريلز التجريبية؟
نعم. أضف trial_params مع graduation_strategy إلى حاوية REELS وانشرها كالمعتاد، سواء مع Instagram Login أو Facebook Login.
هل يمكن استخدام trial_params على صورة أو كاروسيل؟
لا. لا تقبل Meta trial_params إلا على حاوية media_type فيها REELS، لذلك لا يمكن أن تكون حاويات الصور والكاروسيل والستوري منشورات تجريبية.
هل يرى المتابعون الريل التجريبي؟
ليس في البداية. يُعرض الريل التجريبي لغير المتابعين فقط، ويصل إلى المتابعين بعد تخرجه.
ما أقصى مدة للريل التجريبي؟
المدة نفسها لأي ريل: من 3 ثوانٍ إلى 15 دقيقة، بملف MOV أو MP4 يصل حجمه إلى 300 MB، على عنوان URL عام تستطيع Meta جلبه.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في