‏واجهة Instagram Graph API‏

الوسائط التي تتضمن ذكرًا

يمكن إرجاع بيانات حول وسائط IG التي تم @ذكر مستخدم IG في الشرح التوضيحي التابع لها بواسطة مستخدم Instagram آخر.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /{ig-user-id}?fields=mentioned_media.media_id

يتم إرجاع بيانات حول وسائط IG التي تم @ذكر مستخدم IG في الشرح التوضيحي التابع لها بواسطة مستخدم Instagram آخر.

التقييدات

  • عمليات الذكر في القصص غير مدعومة.
  • التعليق على الصور التي تمت فيها الإشارة إليك غير مدعوم.
  • لن يتم إرسال أحداث Webhooks في حالة إنشاء الوسائط التي يظهر التعليق أو @الذكر عليها من قِبل حساب يتم تعيينه إلى خاص.

المتطلبات

النوع الوصف

رموز الوصول

المستخدم

الأذونات

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list


إذا تم منح مستخدم التطبيق دورًا في الصفحة عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي:


ads_management
business_management

المهام

MANAGE أو CREATE_CONTENT أو MODERATE

بنية الطلب

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

معلمات سلسلة الاستعلام

المعلمةالقيمة

{access_token}
مطلوب
سلسلة

تمثل رمز وصول المستخدم الخاص بمستخدم التطبيق.

{fields}
قائمة مفصولة بفاصلة

يمثل قائمة مفصولة بفاصلة تضم حقول وسائط IG التي تريد إرجاعها. وإذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

{media-id}
مطلوب
سلسلة

يمثل معرف وسائط IG الذي تم فيه @ذكر مستخدم IG في أحد الشروحات التوضيحية. ويتم تضمين المعرف في حمولة بيانات إشعار حدث Webhook.

الحقول

الحقلالوصف

caption
سلسلة

يمثل نص الشرح التوضيحي. ولن تتضمن الشروحات التوضيحية التي @تذكر مستخدم IG الرمز @ ما لم ينشئ مستخدم التطبيق كائن وسائط IG الذي تم بناءً عليه إجراء الشرح التوضيحي.

comments
كائن

يمثل قائمة بتعليقات IG على وسائط IG. وفي حالة استخدام توسيع الحقل للحصول على نص التعليق، لن يتضمن النص الذي @يذكر مستخدم IG الرمز @ ما لم ينشئ مستخدم التطبيق كائن وسائط IG الذي تم بناءً عليه إجراء الشرح التوضيحي.

comments_count
سلسلة

يمثل عدد تعليقات IG على وسائط IG.

id
افتراضي
سلسلة

يمثل معرف وسائط IG.

String (سلسلة)like_count

يمثل عدد تسجيلات الإعجاب على الوسائط. يمكن استبعاد تسجيلات الإعجاب على وسائط الصور الفرعية في الألبوم وتسجيلات الإعجاب على المنشورات المروّج لها والتي تم إنشاؤها من الوسائط. يتضمن الردود الموجودة على التعليقات.


  • استدعاءات الإصدار 10.0 والإصدارات الأقدم: ستكون القيمة 0 إذا كان مالك الوسائط لديه أعداد إعجاب مخفية عليها.
  • استدعاءات الإصدار 11.0 والإصدارات الأحدث: سيتم حذف الحقل إذا كان مالك الوسائط لديه أعداد إعجاب مخفية عليها وستكون القيمة 0 إذا كان مالك الوسائط لديه أعداد إعجاب مخفية عليها.

media_type
سلسلة

يمثل نوع وسائط IG: CAROUSEL_ALBUM أو IMAGE أو STORY أو VIDEO.

media_url
سلسلة

يمثل عنوان URL لوسائط IG المنشورة.

owner
سلسلة

يمثل معرف مستخدم IG الذي أنشأ وسائط IG. ولا يتم إرجاعه إلا إذا أنشأ مستخدم التطبيق كائن وسائط IG، وإلا فسيتم إرجاع الحقل username بدلًا من ذلك.

timestamp
سلسلة

يمثل تاريخ إنشاء وسائط IG بتنسيق ISO 8601.

username
سلسلة

يمثل اسم المستخدم التابع لمستخدم IG الذي أنشأ وسائط IG.

عينة من الطلب

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

عينة من الاستجابة

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

لاحظ أنه في العينة السابقة، قد أزالت واجهة API الرمز @ الموجودة كعلامة بادئة من الشرح التوضيحي الأصلي (‎@metricsaurus headquarters!‎) نظرًا لأن مستخدم التطبيق لم ينشئ الشرح التوضيحي.

تقسيم الصفحات

إذا كنت تستخدم توسيع الحقل للوصول إلى عنصر الربط الذي يدعم ميزة تقسيم الصفحات القائم على المؤشر، فستتضمن الاستجابة المؤشرين before وafter إذا كانت الاستجابة تحتوي على صفحات متعددة من البيانات. على عكس تقسيم الصفحات القياسي القائم على المؤشر، لن تتضمن الاستجابة الحقل previous أو next، لذلك سيتعين عليك استخدام المؤشرين before وafter لإنشاء سلسلتي الاستعلام previous وnext يدويًا حتى تتمكّن من تصفح مجموعة البيانات التي تم إرجاعها.

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.