‏منصة Instagram‏

سجل التغييرات

يشير سجل التغييرات هذا إلى التغييرات التي تم إجراؤها على واجهة Instagram Graph API.

سجلات التغييرات ذات الصلة

12 سبتمبر 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9 نوفمبر 2022

أحداث Webhooks في Instagram

ينطبق على كل الإصدارات.

سيتم إرجاع ad_id وad_title في الكائن media لدى كائن value في الحقل comments عندما يعلق شخص ما على منشور Instagram الذي تم ترويجه أو منشور إعلانات Instagram.

31 أكتوبر

ريلز - إشارات المنتجات

ينطبق على كل الإصدارات.

تم توفير API الإشارة إلى المنتجات في Instagram للريلز. يمكنك الإشارة إلى ما يصل إلى 30 منتجًا عند نشر مقطع ريلز.

28 يونيو 2022

مقاطع ريلز

تنطبق على كل الإصدارات.

مقاطع ريلز مدعومة الآن. لنشر فيديو كمقطع ريلز، قم بتعيين المعلمة media_type على REELS عند إنشاء حاوية منشور وسائط فردي. ارجع إلى المرجع POST /ig-user/media endpoint لمعرفة المعلمات التي يمكن استخدامها مع مقاطع ريلز بالإضافة إلى متطلبات مقاطع فيديو ريلز.

27 يونيو 2022

مستندات Instagram API القديمة

تنطبق على كل الإصدارات.

تمت إزالة مستندات مطوّر Instagram API القديمة وتتم إعادة التوجيه الآن إلى مستندات مطوّر منصة Instagram.

20 يونيو 2022

الإشارة إلى المنتجات

تنطبق على كل الإصدارات.

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

27 مايو 2022

الأشكال المتنوعة للمنتجات

ينطبق على كل الإصدارات.

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

15 مارس 2022

منشورات الإعلانات الدوّارة

ينطبق على كل الإصدارات.

يمكنك الآن استخدام Instagram API لنشر المنشورات التي تحتوي على عدة صور ومقاطع فيديو (منشورات الإعلانات الدوَّارة). يمكن الرجوع إلى دليل نشر المحتوى للتعرف على خطوات النشر الكاملة.

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

9 نوفمبر 2021

مقاطع فيديو البث المباشر

تنطبق على كل الإصدارات.

يمكنك الآن استخدام واجهة Instagram API للحصول على وسائط IG لفيديو البث المباشر التي يتم بثها بواسطة مستخدمي تطبيقك والحصول على تعليقات على مقاطع الفيديو هذه واستخدام واجهة API المراسلة في Instagram لإرسال الردود الخاصة (رسائل مباشرة) إلى مؤلفي التعليقات. ولدعم هذه الوظيفة، تم إجراء التغييرات التالية:

  • يمكن لعنصر ربط GET /ig-user/live_media الجديد إرجاع وسائط IG لفيديو البث المباشر الذي يتم بثه بواسطة مستخدم تطبيقك في وقت إجراء الطلب
  • يتم الآن إرجاع الحقل media في تعليق IG والكائن الذي يحتوي على كل من المعرف (id) والموقع المنشور (media_product_type) للوسائط التي تم التعليق عليها
  • يمكن لحقل Instagram Webhooks live_comments الجديد إرسال إشعارات تحتوي على تعليقات بث مباشر تم وضعها على مقاطع فيديو البث المباشر لمستخدمي تطبيقك أثناء بثها

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

20 أكتوبر 2021

تعليقات IG

تنطبق على كل الإصدارات.

تمت إضافة حقلين جديدين إلى تعليقات IG:

  • from - يعمل على إرجاع كائن يحتوي على IGSID (id) واسم المستخدم (username) لمنشئ التعليق.
  • parent_id - يعمل على إرجاع معرف تعليق IG الأصل إذا تم إنشاء هذا التعليق على تعليق IG آخر (مثل رد على تعليق آخر).

Instagram Webhooks

تنطبق على كل الإصدارات.

يتضمن الآن حقل Instagram webhooks comments الخصائص التالية في كائن الحقل value:

  • from.id - IGSID لمستخدم Instagram الذي أنشأ التعليق.
  • from.username - اسم المستخدم لمستخدم Instagram الذي أنشأ التعليق
  • media.id - معرف وسائط IG التي تم التعليق عليها.
  • media.media_product_type - مكان عرض (الموقع المنشور) وسائط IG التي تم التعليق عليها.
  • parent_id - معرف تعليق IG الأصل إذا تم إنشاء هذا التعليق على تعليق IG آخر (مثل رد على تعليق آخر).

5 أكتوبر 2021

يتم تطبيق التغييرات التالية على مقاطع فيديو Instagram TV التي تم إنشاؤها في يوم 5 أكتوبر 2021 أو بعده. ويتم استثناء مقاطع فيديو Instagram TV التي تم إنشاؤها قبل هذا التاريخ من هذه التغييرات.

  • سيعمل الحقلmedia_product_type على إرجاع FEED بدلاً من IGTV
  • لن يتم إرجاع الحقلvideo_title
  • يتم دعم Instagram Webhooks والحقلين comments وmentions في الوقت الحالي

في 3 يناير 2022، سيتم تطبيق التغييرات أعلاه على كل إصدارات واجهة API وكل مقاطع فيديو Instagram TV، بغض النظر عن تاريخ إنشاء الفيديو. وهذا يعني أنه بداية من 3 يناير 2022، ستتمكن التطبيقات التي تستخدم إصدار واجهة API أقدم من الاستعلام عن مقاطع فيديو Instagram TV (تم طرح دعم القراءة في الإصدار 10.0 ويقتصر فقط على الإصدار 10.0 والإصدارات الأحدث).

بداية من الإصدار 14.0، لن يتم دعم الحقل video_title وستعرض واجهة API خطأً إذا تم طلب الحقل.

8 يونيو 2021

أعداد تسجيلات الإعجاب

ينطبق ذلك على الإصدار 11.0 والإصدارات الأحدث. وسينطبق على كل الإصدارات اعتبارًا من 7 سبتمبر 2021.

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


تقسيم الصفحات استنادًا إلى الوقت

ينطبق على الإصدار 11.0 والإصدارات الأحدث.

تمت إضافة المعلمتين since وuntil إلى نقطة النهاية GET /{ig-user-id}/media لدعم تقسيم الصفحات استنادًا إلى الوقت.

26 مايو 2021

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

4 مايو 2021

تم إجراء تغيير صغير على كيفية حساب أداة القياس online_followers لدى مستخدمي IG.

14 أبريل 2021

لن يتم تضمين تفاعلات وسائط IG للقصص والتي تم إجراؤها بواسطة المستخدمين في اليابان في بعض عمليات حساب أدوات القياس replies:

  • بالنسبة للقصص التي أنشأها المستخدمون داخل اليابان، ستعمل الآن أداة القياس replies على إرجاع قيمة 0.
  • بالنسبة للقصص التي أنشأها المستخدمون خارج اليابان، ستعمل أداة القياس replies على إرجاع عدد من الردود، ولكن لن يتم تضمين الردود التي أنشأها المستخدمون داخل اليابان في عملية الحساب.

12 أبريل 2021

تم إصلاح خطأ بسيط يتعلق بإمكانية الوصول إلى أدوات القياس في وسائط IG للقصة.

9 أبريل 2021

  • يقوم الحقل status الموجود في حاوية IG الآن بإرجاع الرمز الفرعي للخطأ إذا كان الحقل error_code في الحاوية بقيمة ERROR.
  • تدعم الآن أداة القياس video_views لدى رؤى وسائط IG الألبومات وستعمل على إرجاع مجموع video_views في كل مقاطع الفيديو الموجودة في الألبوم بدلًا من القيمة 0.

16 مارس 2021

يتم الآن دعم وسائط IGTV في الإصدار 10.0 والإصدارات الأحدث. وينطبق ذلك على كل نقاط النهاية باستثناء نقاط النهاية المُستخدمة في نشر المحتوى وأحداث Webhooks. ولدعم هذا التغيير، تمت إضافة الحقلين الجديدين media_product_type وvideo_title إلى العقدة وسائط IG. ويجب مشاركة وسائط IGTV في Instagram في وقت النشر (تم تمكين نشر معاينة أو مشاركة معاينة في الموجز) ليمكن الوصول إليها عبر واجهة API.

26 يناير2021

انتهى الإصدار التجريبي لنشر المحتوى ويمكن لكل المطوّرين الآن نشر الوسائط على الحسابات الاحترافية في Instagram. ويرجى الرجوع إلى دليل نشر المحتوى للحصول على تفاصيل الاستخدام.

2 ديسمبر 2020

امتثالاً لتوجيهات الخصوصية الإلكترونية من جانب الاتحاد الأوروبي، لن يتم تضمين تفاعلات وسائط IG للقصص المتعلقة بالمراسلات والتي تم إجراؤها بواسطة المستخدمين داخل المنطقة الاقتصادية الأوروبية (EEA) بعد تاريخ 1 ديسمبر 2020 في بعض عمليات حساب أدوات القياس:

  • بالنسبة إلى القصص التي أنشأها المستخدمون داخل المنطقة الاقتصادية الأوروبية (EEA)، ستعمل أداة القياس replies الآن على إرجاع القيمة 0.
  • بالنسبة للقصص التي أنشأها المستخدمون خارج المنطقة الاقتصادية الأوروبية (EEA)، ستعمل أداة القياس replies على إرجاع عدد الردود، ولكن لن يتم تضمين الردود التي أنشأها المستخدمون داخل المنطقة الاقتصادية الأوروبية (EEA) في عملية الحساب.

ينطبق هذا التغيير على كل الإصدارات.

10 نوفمبر 2020

  • رؤى مستخدم IG — أصبحت قيم follower_count تتوافق الآن بشكل أوثق مع القيم المقابلة لها والمعروضة في تطبيق Instagram. بالإضافة إلى ذلك، تقوم قيم follower_count الآن بإرجاع بيانات 30 يومًا كحد أقصى بدلًا من عامين. علمًا بأن هذا التغيير ينطبق على الإصدار 9.0 والإصدارات الأحدث، وسينطبق على كل الإصدارات اعتبارًا من 9 مايو 2021.

5 مايو 2020

3 ديسمبر 2019

  • الرؤى — لمحاذاة سلوك واجهة API مع سلوك تطبيق Instagram، تتوفر الآن رؤى حول مستخدمي IG فقط بالنسبة لمستخدمي IG الذين لديهم 100 متابع أو أكثر.

13 أغسطس 2019

22 مايو 2019

9 مايو 2019

  • أحداث Webhooks — يتطلب الآن الحقل story_insights توفير الإذن instagram_manage_insights بدلًا من instagram_manage_comments.

31 أكتوبر 2018

  • واجهة API البحث بالهاشتاج — يمكنك الآن البحث عن الوسائط التي تتضمن علامات هاشتاج محددة باستخدام واجهة API البحث بالهاشتاج الجديدة التي نوفرها. #spooky!

23 أكتوبر 2018

  • عنصر الربط /{ig-media-id}/comments — سيتم إرجاع نتائج طلبات GET التي تم إجراؤها باستخدام واجهة API بالإصدار 3.1 أو الإصدارات الأقدم حسب الترتيب الزمني. وسيتم إرجاع نتائج الطلبات التي تم إجراؤها باستخدام الإصدار 3.2 أو الإصدارات الأحدث بترتيب زمني معكوس.

7 يونيو 2018

  • العقدة /{ig-media-id} — يمكنك الآن استخدام توسيع الحقل للحصول على الحقل permalink في كائنات الوسائط.

1 مايو 2018

  • التحقق من النشاط التجاري — من أجل استخدام واجهة Instagram Graph API، يجب أن تخضع كل التطبيقات لإجراء التحقق من النشاط التجاري الذي يكون جزءًا من عملية مراجعة التطبيقات، ويلزم إجراؤه الآن لكل نقاط نهاية واجهة Instagram Graph API. ويتعين أن تخضع التطبيقات التي تمت مراجعتها مسبقًا قبل تاريخ 1 مايو 2018 إلى المراجعة مرة أخرى، ويتعين مراجعتها حتى 1 أغسطس 2018، وإلا فستفقد الوصول إلى واجهة API.

24 أبريل 2018

  • العقدة /{ig-comment-id}:
    • تمت إضافة حقل username جديد.
    • بالنسبة لطلبات GET، لن يتم تضمين الحقل user في الاستجابات ما لم يكن المستخدم الذي يقدم الطلب هو صاحب التعليق، وبدلًا من ذلك، سنعمل على إرجاع username لكل أصحاب التعليقات. وينطبق ذلك أيضًا على الاستعلامات حول التعليقات التي تمت عبر واجهات API أخرى، مثل واجهة API عمليات الذِكر.
  • العقدة /{ig-media-id}:
    • تمت إضافة حقل username جديد.
    • بالنسبة لطلبات GET، لن يتم تضمين الحقل owner في الاستجابات ما لم يكن المستخدم الذي يقدم الطلب هو صاحب كائن الوسائط، وبدلًا من ذلك، سنقوم بإرجاع username لكل أصحاب التعليقات. وينطبق ذلك أيضًا على الاستعلامات حول كائنات الوسائط التي تمت عبر واجهات API أخرى، مثل واجهة API عمليات الذِكر.

23 أبريل 2018

  • واجهة API الرؤى — ستتضمن الرؤى الآن النشاط الإعلاني الذي تم إنشاؤه من خلال واجهة API وواجهات إعلانات فيسبوك وميزة الترويج على Instagram. ويؤثر ذلك على أدوات القياس التالية:

    • impressions
    • reach

13 مارس 2018

  • واجهة API نشر المحتوى — يمكن لشركاء الإصدار التجريبي الآن استخدام عنصر الربط /{ig-user-id}/media للإشارة إلى المواقع وحسابات مستخدمي Instagram العامة عند نشر الصور.

8 مارس 2018

  • الحقول العامة — أصبح الحقل timestamp في العقدة /{ig-media-id} الآن حقلًا عامًا ويمكن إرجاعه عبر توسيع الحقل.

22 فبراير 2018

  • الحقول العامة — ستقوم العُقد /{ig-user-id} و/{ig-comment-id} و/{ig-media-id} الآن بإرجاع كل الحقول العامة عند الوصول إليها من خلال عنصر ربط عبر توسيع الحقل. ويمكنك الرجوع إلى المستند المرجعي لكل عقدة لمعرفة الحقول العامة.

8 فبراير 2018

  • واجهة API نشر المحتوى — يمكن لشركاء الإصدار التجريبي الآن تضمين علامات الهاشتاج عند نشر الصور عبر عنصر الربط /{ig-user-id}/media. #crazywildebeest رائع!