‏منصة Instagram‏

سجل التغييرات لمنصة Instagram

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

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

3 أكتوبر 2024

أصبحت تدفقات الرسائل الترحيبية متوفرة الآن في Instagram API مع تسجيل دخول Instagram. معرفة المزيد.

2 أكتوبر 2024

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

17 سبتمبر 2024

قيم scope جديدة

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

لضمان الاتساق بين قيم scope وأسماء الأذونات، نقدم قيم scope جديدة لـ Instagram API مع تسجيل دخول Instagram. قيم scope الجديدة هي:

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

ستحل هذه القيم محل القيم business_basic وbusiness_content_publish وbusiness_manage_comments وbusiness_manage_messages الموجودة على التوالي.

الرجاء ملاحظة أنه سيتم إيقاف استخدام قيم scope القديمة في 27 يناير 2025. من الضروري تحديث الرمز قبل هذا التاريخ لتجنب أي تعطيل في وظائف التطبيق. سيؤدي الفشل في القيام بذلك إلى عدم تمكن التطبيق من استدعاء نقاط نهاية Instagram.

تصحيح: تم تأجيل تاريخ إيقاف الاستخدام من 17 ديسمبر 2024 إلى 27 يناير 2025.

23 يوليو 2024

طرح Instagram API جديدة مع تسجيل دخول Instagram

مكونات Instagram API الجديدة:

  • لن تكون صفحة فيسبوك مطلوبة بعد الآن
  • عنوان URL المضيف لاستدعاءات API هو graph.instagram.com
  • الأذونات الجديدة لواجهة API هذه:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • لن يتم استخدام Messenger API بعد الآن لإرسال رسائل Instagram
  • ستضيف التطبيقات الجديدة منتج Instagram الجديد عند إنشاء تطبيق Meta
  • يمكن للتطبيقات الحالية إضافة منتج Instagram الجديد في لوحة معلومات التطبيق

تفضل بزيارة دليل الترحيل الذي نوفره لمعرفة ما إذا كانت Instagram API الجديدة مع تسجيل دخول Instagram مناسبة لك.

11 يونيو 2024

أحداث Webhooks لتعليق Instagram

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

بالإضافة إلى ad_id وad_title، سيتم إرجاع original_media_id في الكائن media لكائن comments في الحقل value عندما يعلق الشخص على منشور Instagram تم ترويجه أو منشور إعلانات Instagram. لمزيد من المعلومات، راجع إعداد أحداث Webhooks في Instagram.

21 مايو 2024

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

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

Instagram Webhooks

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

سيتم إرجاع 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 رائع!