‏منصة Instagram‏
عودة إلى اللغة ‏العربية‏
تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏١ سبتمبر‏

وسائط IG

تمثل ألبوم أو صورة أو فيديو (فيديو تم تحميله أو فيديو بث مباشر أو فيديو تم إنشاؤه باستخدام تطبيق Instagram TV أو مقطع ريلز أو قصة) في Instagram.

بدءًا من 3 يونيو 2024، يمكنك استخدام الحقل boost_eligibility_info كطريقة سهلة وفعالة لتحديد ما إذا كانت الوسائط مؤهلة للترويج كإعلان واستخدام الحقل boost_ads_list لتتبع المعلومات المتعلقة بإعلان Instagram السابق الذي تم ترويجه. راجع المدونة لمزيد من المعلومات. متوفر لواجهة Instagram Graph API فقط.

الإنشاء

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

القراءة

GET /<IG_MEDIA_ID>

يتم الحصول على الحقول وعناصر الربط في وسائط IG.

التقييدات

  • لا تتضمن الحقول التي تقوم بإرجاع قيم مجمّعة البيانات المستندة إلى الإعلانات. فعلى سبيل المثال، تحسب أداة القياس comments_count عدد التعليقات على صورة، وليس عدد التعليقات على الإعلانات التي تحتوي على هذه الصورة.
  • لا تتضمن الشروحات التوضيحية الرمز @ ما لم يكن مستخدم التطبيق قادرًا أيضًا على تنفيذ مهام مكافئة لدور المسؤول داخل التطبيق.
  • لا يمكن استخدام بعض الحقول، مثل permalink، في الصور داخل الألبومات (الصور الفرعية).
  • لا يمكن قراءة وسائط IG لفيديو البث المباشر إلا أثناء البث.
  • تُرجع API هذه بيانات الوسائط المملوكة بواسطة حسابات Instagram الاحترافية فقط. لا يمكن استخدامها للحصول على بيانات الوسائط المملوكة بواسطة حسابات Instagram الشخصية.

بنية الطلب

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

معلمات المسار

العنصر النائبالقيمة

<API_VERSION>

إصدار API.

<IG_MEDIA_ID>

مطلوب. معرف الوسائط التي سيتم نشرها.

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

المفتاحالعنصر النائبالقيمة

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

يمثل قائمة مفصولة بفاصلة تتضمن الحقول التي تريد إرجاعها.

الحقول

يمكن قراءة الحقول العامة عبر توسيع الحقل.

الحقلالوصف

boost_ads_list

يوفر نظرة عامة حول كل معلومات إعلانات Instagram المرتبطة بالوسائط العادية. يتضمن معرف الإعلان المرتبط وحالة عرض الإعلان. متوفر لواجهة Instagram Graph API فقط.

boost_eligibility_info

يوفر الحقل معلومات حول أهلية الترويج لوسائط Instagram على IG كإعلان وتفاصيل إضافية إذا لم تكن مؤهلة. متوفر لواجهة Instagram Graph API فقط.

caption
عام

الشرح التوضيحي. ويمكن استبعاد الصور الفرعية في الألبوم. يتم استبعاد الرمز @ ما لم يتمكّن مستخدم التطبيق من تنفيذ مهام مكافئة لدور المسؤول في صفحة فيسبوك المرتبطة بحساب Instagram المُستخدم في إنشاء الشرح التوضيحي (واجهة Instagram Graph API فقط.).

comments_count
عام

عدد التعليقات على الوسائط. ويتم استبعاد التعليقات على وسائط الصور الفرعية في الألبوم والشرح التوضيحي للوسائط. يتضمن الردود الموجودة على التعليقات.

copyright_check_information.status

يتم إرجاع الكائنين status وmatches_found

كائنات statusالوصف

status

  • completed – تم إنهاء عملية الاكتشاف
  • error – حدث خطأ أثناء عملية الاكتشاف
  • in_progress – عملية الاكتشاف مستمرة
  • not_started – لم تبدأ عملية الاكتشاف

matches_found

يمكن التعيين على أحد ما يلي:

  • false إذا لم ينتهك الفيديو حقوق النشر،
  • وtrue إذا انتهك الفيديو حقوق النشر

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

كائنات copyright_matchesالوصف

author

مؤلف الفيديو المحمي بموجب حقوق النشر

content_title

اسم الفيديو المحمي بموجب حقوق النشر

matched_segments

مصفوفة كائنات تتضمن أزواج القيمة والمفاتيح التالية: * duration_in_seconds - عدد الثواني التي ينتهك فيها المحتوى حقوق النشر * segment_type - إما AUDIO أو VIDEO * start_time_in_seconds - يتم التعيين على وقت بدء الفيديو

owner_copyright_policy

تتضمن الكائنات التي يتم إرجاعها ما يلي:

  • name – اسم سياسة مالكي حقوق النشر

  • actions – مصفوفة كائنات action تتضمن خطوات المعالجة المتخذة والتي تحددها سياسة مالك حقوق النشر. قد تتضمن خطوات معالجة مختلفة للمواقع المختلفة.

    • action – إجراء المعالجة الذي تم اتخاذه ضد الفيديو المنتهك لحقوق النشر. يمكن اتخاذ خطوات معالجة مختلفة للبلدان المختلفة. يمكن أن تكون إحدى القيم التالية:
      • BLOCK – يتم حظر الفيديو من الجماهير المدرجة في مصفوفة geos
      • MUTE - يتم كتم صوت الفيديو للجماهير المدرجة في مصفوفة geos

id
عام

معرف الوسائط.

is_comment_enabled

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

is_shared_to_feed
عام

لمقاطع ريلز فقط. عندما تكون القيمة true، يشير ذلك إلى إمكانية ظهور مقطع ريلز في علامتي التبويب الموجز وريلز. وعندما تكون القيمة false، هذا يشير إلى أن مقطع ريلز لا يمكنه الظهور سوى في علامة التبويب ريلز.

لاحظ أن القيمتين لا تحددان ما إذا كان مقطع ريلز يظهر بالفعل في علامة التبويب ريلز، نظرًا لأن مقطع ريلز قد لا يفي بمتطلبات الأهلية أو قد لا يتم تحديده بواسطة الخوارزمية لدينا. راجع مواصفات مقطع ريلز للاطلاع على معايير الأهلية.

like_count

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


إذا تم الاستعلام بشكل غير مباشر من خلال نقطة نهاية أخرى أو توسيع حقل، فسيتم حذف الحقل like_count إذا قام مالك الوسائط بإخفاء عدد تسجيلات الإعجابات.

media_product_type
عام

يمثل الجهة التي يتم نشر الوسائط بها. يمكن أن تكون AD أو FEED أو STORY أو REELS. متوفر لواجهة Instagram Graph API فقط.

media_type
عام

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

media_url
عام

عنوان URL الوسائط.

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

owner
عام

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

permalink
عام

عنوان URL ثابتًا للوسائط.

shortcode
عام

الرمز القصير للوسائط.

thumbnail_url
عام

عنوان URL للصورة المصغرة الخاصة بالوسائط. ولا يتوفر إلا على وسائط VIDEO.

timestamp
عام

تاريخ إنشاء بتنسيق ISO 8601 وبتوقيت UTC (التوقيت الافتراضي هو UTC ±00:00).

username
عام

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

عناصر الربط

يمكن إرجاع عناصر الربط العامة عبر توسيع الحقل.

عنصر الربطالوصف

children
عام.

يمثل مجموعة من كائنات وسائط IG الموجودة في وسائط IG للألبوم.

collaborators

يمثل قائمة بالمستخدمين الذين تمت إضافتهم كمتعاونين في كائن وسائط IG. متوفر لواجهة Instagram Graph API فقط.

comments

يمكن أن تمثل مجموعة من تعليقات IG على كائن وسائط IG.

insights

يمثل أدوات قياس التفاعل على وسائل التواصل الاجتماعي في كائن وسائط IG. متوفر لواجهة Instagram Graph API فقط.

مثال على cURL

مثال على الطلب

curl -X GET \
  'https://graph.instagram.com/v21.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

مثال على الاستجابة

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

التحديث

POST /<IG_MEDIA_ID>

يتم تمكين التعليقات على وسائط IG أو تعطيلها.

التقييدات

وسائط IG لفيديو البث المباشر غير مدعومة.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • business_management

بنية الطلب

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

معلمات المسار

العنصر النائبالقيمة

<API_VERSION>

إصدار API.

<IG_MEDIA_ID>

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

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

المفتاحالعنصر النائبالقيمة

access_token

<ACCESS_TOKEN>

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

comment_enabled

<BOOL>

مطلوب. قم بالتعيين على true لتمكين التعليقات أو على false لتعطيل التعليقات.

مثال على cURL

مثال على الطلب

curl -i -X POST \
 "https://graph.instagram.com/v21.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

مثال على الاستجابة

{
  "success": true
}

الحذف

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