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

النص البديل في منشورات Instagram عبر واجهة برمجة التطبيقات (API)

تضيف API من Instagram نصًا بديلًا لمنشور الصورة عبر المعامل alt_text، ويُضبط عند إنشاء حاوية الوسائط. يتسع لـ 1,000 حرف، ويعمل على صورة واحدة أو على كل صورة في الألبوم المتعدد، بينما لا يُدعم في Reels و Stories. أضافت Meta الحقل في 24 مارس 2025.

يتيح easyCoexistence نشر الصور والألبومات المتعددة بالأداة publish_instagram_post من Claude أو ChatGPT أو من شيفرتك البرمجية.

1,000

أكبر عدد من أحرف النص البديل يمكن لصورة واحدة أن تحمله عبر API.

24 Mar 2025

متى قدّمت Meta حقل alt_text لمنشورات الصور على نقطة النهاية (endpoint) الخاصة بالوسائط.

Images only

يعمل alt_text على الصور المنفردة وصور الألبوم المتعدد، ولا تدعمه Reels أو Stories.

alt_text

حقل في الوسائط المنشورة يعيد النص الوصفي للصورة لأغراض إمكانية الوصول.

ما هو النص البديل في منشور Instagram؟

وصف مكتوب للصورة، تسميه وثائق الوسائط لدى Meta «الوصف النصي للصور»، ويُقدَّم لأغراض إمكانية الوصول. عبر API يُضبط لكل صورة بالمعامل alt_text عند إنشاء حاوية الوسائط، ويُقرأ من الحقل alt_text بعد نشر المنشور.

كيف يُضاف النص البديل؟

بالمعامل alt_text على حاوية الصورة. يؤدي الطلب POST /<IG_ID>/media ومعه image_url والتسمية التوضيحية والمعامل alt_text إلى إنشائها، ثم ينشرها الطلب POST /<IG_ID>/media_publish كالمعتاد. في حالة الألبوم المتعدد، اضبط alt_text على حاوية كل عنصر صورة، أي الحاويات التي أُنشئت بقيمة is_carousel_item تساوي true، وذلك قبل إنشاء حاوية الألبوم.

An image container with alt text
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/photo.jpg",
  "caption": "<CAPTION>",
  "alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}

أي المنشورات تدعم النص البديل؟

منشورات الصور فقط، كما تصف وثائق Meta هذا المعامل:

  • منشور صورة منفردة: مدعوم، حتى 1,000 حرف.
  • الصور داخل الألبوم المتعدد: مدعومة، ولكل صورة نصها الخاص.
  • مقاطع الفيديو، بما فيها عناصر الفيديو داخل الألبوم: غير مدعومة.
  • Reels و Stories: غير مدعومة.
  • حاوية الألبوم نفسها: يُكتب النص على عناصر الصور بدلًا منها.

كيف يُقرأ النص البديل مرة أخرى؟

بطلب الحقل alt_text من الصورة المنشورة: GET /<IG_MEDIA_ID>?fields=alt_text. وهو حقل عام من كائن الوسائط، لذلك يمكن طلبه أيضًا لصور الألبوم المتعدد عبر الحافة children، التي تسرد الصور ومقاطع الفيديو داخل المنشور.

هل يمكن تغيير النص البديل بعد النشر؟

لا توثّق Meta أي طريقة لذلك. التحديث الوحيد الذي تدرجه وثيقة الوسائط لمنشور منشور هو تشغيل التعليقات أو إيقافها، لذلك يُكتب النص البديل في الحاوية قبل نشر المنشور، مع التسمية التوضيحية وعنوان URL للصورة.

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

  • إرسال alt_text مع Reel أو Story. تدعمه Meta في منشورات الصور فقط.
  • وضعه على حاوية الألبوم. النص البديل يخص كل عنصر صورة داخل الألبوم.
  • تجاوز 1,000 حرف. هذا أقصى ما يتسع له النص البديل لصورة واحدة.
إنجاز ذلك باستخدام EasyCoexistence

لا تقبل الأداة alt_text، لذلك يُضاف الوصف داخل تطبيق Instagram، من خيار التعديل (Edit) الخاص بالمنشور. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

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

ما أقصى طول للنص البديل عبر Instagram API؟

حتى 1,000 حرف لكل صورة، يُضبط بالمعامل alt_text على حاوية كل صورة، فتأخذ كل صورة في الألبوم نصها الخاص.

هل يمكن أن يحمل Reel نصًا بديلًا عبر API؟

لا. لا تدعم Meta الحقل alt_text في Reels أو Stories.

كيف أضيف النص البديل إلى الألبوم المتعدد؟

اضبط alt_text على حاوية كل عنصر صورة، التي تُنشأ بقيمة is_carousel_item تساوي true، قبل إنشاء حاوية الألبوم.

متى أضافت Instagram API النص البديل؟

قدّمت Meta الحقل alt_text لمنشورات الصور في 24 مارس 2025.

تابع القراءة

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

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

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

تم التحقق في