‏منصة Instagram‏

وسائط IG

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

الإنشاء

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

القراءة

GET /{ig-media-id}

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

التقييدات

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

المتطلبات

النوعالوصف

رموز الوصول

المستخدم.

الأذونات

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

بنية الطلب

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

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

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

{api-version}

يمثل إصدار API.

{ig-media-id}

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

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

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

access_token

{access-token}

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

fields

{fields}

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

الحقول

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

الحقلالوصف

caption
عام

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

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
عام

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

ig_id
عام

معرف الوسائط على Instagram. كان يُستخدم في Instagram API القديمة، وتم إيقاف استخدامه حاليًا. استخدم id بدلاً من ذلك.

is_comment_enabled

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

is_shared_to_feed
عام

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

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

like_count

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


إذا تم الاستعلام بشكل غير مباشر عبر نقطة نهاية أخرى أو توسيع حقل:


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

media_product_type
عام

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

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
عام

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

video_title
عام

تم إيقاف الاستخدام. تم الحذف من الاستجابة.

عناصر الربط

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

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

children
عام.

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

collaborators

يمثل قائمة مستخدمين تمت إضافتهم كمساهمين في كائن وسائط IG.

comments

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

insights

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

مثال على cURL

الطلب

curl -X GET \
  'https://graph.facebook.com/v19.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 لفيديو البث المباشر غير مدعومة.

المتطلبات

النوعالوصف

رموز الوصول

المستخدم.

الأذونات

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

بنية الطلب

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

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

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

{api-version}

يمثل إصدار API.

{ig-media-id}

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

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

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

access_token

{access-token}

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

comment_enabled

{comment-enabled}

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

مثال على cURL

الطلب

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

الاستجابة

{
  "success": true
}

الحذف

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