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

وسم الأشخاص وإضافة موقع إلى منشور Instagram عبر API

تتيح واجهة برمجة التطبيقات (API) في Instagram وسم الأشخاص بالحقل user_tags وإضافة مكان بالحقل location_id، ويُضبط الحقلان على حاوية الوسائط (container) قبل نشرها. يسرد user_tags أسماء مستخدمين عامة، ومع الصور تكون الإحداثيات x وy مطلوبة، وهي أرقام من 0.0 إلى 1.0. وتوثّق Meta هذه المعلمة للصور ومقاطع الفيديو والقصص. ويأخذ location_id معرّف Page يحمل بيانات موقع، ويُعثر عليه عبر Pages Search API.

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

0.0 to 1.0

نطاق الإحداثيات x وy في user_tags، ويُقاس من الحافة اليسرى والحافة العلوية للصورة.

Images

الحالات التي يشترط فيها user_tags الحقلين x وy؛ فهما اختياريان في القصص، ولا ينطبقان إلا على الصور والقصص.

Carousels

لا يُدعم location_id على الصور أو مقاطع الفيديو داخل carousel، بحسب مرجع الوسائط لدى Meta.

USER_TAGGING_FAILURE

قيمة config_issue عندما تُنشر الوسائط دون وسوم المستخدمين، وتسميها Meta نجاحًا جزئيًا.

13 Mar 2018

متى فتحت Meta وسم المواقع ومستخدمي Instagram العامين في الصور المنشورة عبر API، ولشركاء النسخة التجريبية أولًا.

كيف تُوسم الأشخاص في منشور؟

أضف user_tags إلى حاوية الوسائط. وهو مصفوفة من كائنات، لكل منها اسم المستخدم لحساب Instagram عام، وعلى الصورة الحقلان x وy: أرقام عشرية من 0.0 إلى 1.0 تحدد مسافة الوسم من الحافة اليسرى ومن الحافة العلوية. ويوضع الموقع في location_id في الطلب نفسه، ثم تُنشر الحاوية عبر media_publish كالمعتاد.

An image container with a user tag and a location
POST /<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/team.jpg",
  "caption": "<CAPTION>",
  "user_tags": [
    { "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
  ],
  "location_id": "<PAGE_ID>"
}

أي المنشورات تقبل وسوم المستخدمين والموقع؟

يصف مرجع الوسائط لدى Meta user_tags للصور ومقاطع الفيديو والقصص، ولا ينطبق الحقلان x وy إلا على الصور والقصص، ويسرد المعلمات التي تقبلها كل حاوية. وفي carousel يوضع الموقع على حاوية الـ carousel نفسها، لأن location_id غير مدعوم على الصور أو مقاطع الفيديو داخله:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

كيف تجد location_id؟

ابحث عن Page. location_id هو معرّف Page مرتبط بموقع، ويشير مرجع Meta إلى Pages Search API، أي نقطة النهاية (endpoint) GET /pages/search مع q وfields=id,name,location، ثم إلى التحقق من أن الـ Page المختارة تحمل بيانات موقع. وتفشل الـ Page التي لا تحمل هذه البيانات بالخطأ INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. ويعمل البحث على Graph API لدى Meta باستخدام رمز الوصول (token) لتطبيق Meta الخاص بك: رمز المستخدم، أو لمعلومات Page العامة رمز التطبيق مع ميزة Page Public Metadata Access.

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

ماذا يحدث إذا لم يُربط الوسم؟

قد يظل المنشور منشورًا. ثم يعيد media_publish القيمة config_issue مضبوطة على USER_TAGGING_FAILURE، أي أن الوسائط نُشرت دون وسوم مستخدميها. وتسمي Meta ذلك نجاحًا جزئيًا، وتطلب من التطبيقات أن تعدّه إشارة إلى ضرورة المطابقة لا خطأً، لأن معرّف الوسائط صالح؛ فإعادة النشر ستُنشئ منشورًا ثانيًا.

هل تعمل وسوم المستخدمين مع Instagram Login؟

يسرد مرجع الوسائط لدى Meta user_tags وlocation_id لإنشاء الحاوية دون ربطهما بتسجيل دخول واحد. أما صفحته الخاصة بـ Instagram API مع Instagram Login فتقول إن هذا الإعداد لا يدعم الإعلانات أو الوسم، دون أن تحدد أي وسم تقصد. قبل البناء على أي من المعلمتين مع Instagram Login، انشر منشورًا تجريبيًا وتحقق من الاستجابة ومن المنشور نفسه.

كيف تضع وسوم الأشخاص عبر easyCoexistence؟

ليس بعد. تنشئ publish_instagram_post الحاوية بنفسها ولا تقبل user_tags أو location_id، ولا يُسلَّم token الخاص بـ Instagram لاستدعاء من شيفرتك. انشر المنشور عبر publish_instagram_post، ثم أضف الوسوم والموقع في تطبيق Instagram من خيار تعديل المنشور.

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

  • ترك x وy فارغين في وسم صورة. تشترط Meta الحقلين على الصور، ولا يكونان اختياريين إلا في القصص.
  • إعطاء الإحداثيات بالبكسل أو بالنسبة المئوية. فـ x وy أرقام عشرية من 0.0 إلى 1.0، تُقاس من الحافة اليسرى والحافة العلوية.
  • ضبط location_id على عناصر carousel. لا تدعمه Meta على الصور أو مقاطع الفيديو داخل carousel.
  • وسم حساب خاص. يقبل user_tags أسماء مستخدمي حسابات Instagram العامة فقط.
إنجاز ذلك باستخدام EasyCoexistence

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

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

هل يمكنني وسم حساب Instagram خاص عبر API؟

لا. يقول مرجع الوسائط لدى Meta إن user_tags يقبل أسماء مستخدمي حسابات Instagram العامة، لذلك لا يمكن وسم حساب خاص بهذه الطريقة.

كم عدد الأشخاص الذين يمكن وسمهم في منشور واحد؟

لا يذكر مرجع Meta لـ user_tags حدًا أقصى. أما الحد البالغ 20 الذي يذكره فهو للوسوم بـ @ في التعليق.

هل يمكنني إضافة موقع إلى قصة عبر API؟

لا. تسرد صيغة Meta لحاوية القصص user_tags لكنها لا تسرد location_id.

هل يمكنني وسم منتج بدلًا من شخص؟

وسوم المنتجات ميزة منفصلة، وتذكر نظرة Meta العامة أنها مدعومة مع Facebook Login وUnified Login، لا مع Instagram Login.

تابع القراءة

منشورات Instagram التعاونية عبر APIتوضح طريقة نشر Instagram لمنشورات التعاون عبر API: معامل collaborators، وحتى 3 أسماء مستخدمين للصور وReels والألبومات، والدعوات وقواعد تسجيل الدخول.إشارات @mentions على Instagram عبر API: استقبالها والرد عليهاكيف تصل إشارات @ على Instagram عبر API عبر webhook التعليقات مع Instagram Login، وكيفية الرد عليها في التعليقات والتسميات التوضيحية.الحصول على منشورات حساب Instagram عبر واجهة برمجة التطبيقات (API)كيف تسرد API منشورات الحساب بـ GET /<IG_ID>/media: الحقول، وعناصر الكاروسيل، والتصفح بالمؤشر والتاريخ، وخلاصة لموقع.حدود النشر في Instagram API: الصيغ والأحجام والمنشورات في اليومما يحتويه منشور Instagram API وكم منشورًا يمكن نشره يوميًا: صور JPEG حتى 8 MB وReels وStories وتسميات حتى 2,200 حرف و100 منشور كل 24 ساعة.ما الذي تستطيع Instagram API فعله في 2026، وما الذي يبقى داخل التطبيقما تتيحه Instagram API في 2026 عبر Instagram Login: النشر والتعليقات والرسائل المباشرة والإحصاءات والإشارات، وما يبقى داخل التطبيق من الوصف إلى الموسيقى.

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

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

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

تم التحقق في