الانتقال إلى المحتوى الرئيسي
ستدخل التغييرات التالية على واجهة API حيّز التنفيذ في التاريخ المحدد. يُرجى المراجعة بعناية لأي تغييرات محتملة تُحدث كسرًا (breaking changes). انظر ما الجديد لجميع الميزات الجديدة.
​
15 يونيو 2026
  • فيسبوك: أوقفت Meta مقاييس Insights للانطباعات الفريدة (reach) ومشاهدات الفيديو لمدة 3 ثوانٍ. أزالت Meta هذه المقاييس عبر جميع إصدارات Graph API، لذا لم تعد الحقول المتأثرة تُعاد. انظر سجل تغييرات Meta Graph API v25 للتفاصيل.
    • GET analytics/post لم يعد يُعيد حقول فيسبوك التالية:
      • impressionsUnique → انتقل إلى mediaView
      • impressionsFanUnique → انتقل إلى mediaView
      • impressionsOrganicUnique → انتقل إلى mediaView
      • impressionsPaidUnique → انتقل إلى mediaViewIsFromAds
      • videoViewsUnique → استخدم videoViews لمشاهدات الـ 3 ثوانٍ غير الفريدة
      • عائلتا totalVideoViews*Unique وtotalVideoImpressions* (مثل totalVideoViewsOrganicUnique وtotalVideoViewsPaidUnique وtotalVideoViewsUnique)
    • GET analytics/social لم يعد يُعيد حقول فيسبوك التالية:
      • عائلة pagePostsImpressions* (pagePostsImpressions وpagePostsImpressionsPaid وpagePostsImpressionsUnique وpagePostsImpressionsOrganicUnique وpagePostsImpressionsViral* وpagePostsImpressionsNonviral*) → انتقل إلى pageMediaView
      • pagePostsServedImpressionsOrganicUnique → انتقل إلى pageMediaView
      • pageVideoViewsUnique → استخدم pageVideoViews لمشاهدات الـ 3 ثوانٍ غير الفريدة
    • استخدم mediaView / pageMediaView للـ reach. ثمة مقياس بديل لإجمالي مشاهدات الوسائط الفريدة قيد التخطيط. الحقول التي لا تزال مدعومة مثل reactionsByType وvideoViews وmediaView وpagePostEngagements وpageVideoViews وpageVideoViewsPaid لم تتأثر.
​
11 مايو 2026
  • إخفاقات YouTube المؤقتة تُعيد الآن HTTP 503/504 بدلًا من 500: بعض إخفاقات رفع YouTube التي كانت تظهر سابقًا بـ HTTP 500 (code: 176) تُعيد الآن HTTP 503 (code: 454) أو HTTP 504 (code: 453). تتضمن كلتا الاستجابتين retryAvailable: true. تكاملات العملاء التي تعتمد على HTTP 500 لإعادة محاولة رفع YouTube ينبغي أن تنتقل إلى الاعتماد على حقل retryAvailable في جسم الاستجابة. انظر أكواد الأخطاء للتفاصيل.
​
9 أبريل 2026
  • التحليلات الفارغة تُعيد الخطأ 187: طلب التحليلات الاجتماعية أو تحليلات المنشور عندما لا تُعيد أي منصة بيانات يُعيد الآن { "status": "error", "code": 187 } بدلًا من { "status": "success" }. حدّث أي شيفرة عميل تعتمد على سلوك النجاح الفارغ السابق.
​
31 مارس 2026
  • متطلب مفتاح BYO لـ X/Twitter: ستتطلب جميع عمليات X/Twitter عبر Ayrshare بيانات اعتماد API الخاصة بك. بعد ربط حساب X عبر OAuth، ضمّن ترويستَين في كل طلب X/Twitter: X-Twitter-OAuth1-Api-Key وX-Twitter-OAuth1-Api-Secret. سيتم رفض الطلبات التي لا تحمل بيانات اعتماد صالحة. انظر دليل إعداد مفتاح X BYO للتعليمات.
  • إيقاف RSS إلى X: لن يتم دعم النشر التلقائي عبر RSS إلى X/Twitter بعد 31 مارس 2026. تعمل تغذيات RSS وفق جدول دون بيانات اعتماد لكل طلب، وهو غير متوافق مع نموذج BYO للمفاتيح. لا يتأثر النشر التلقائي عبر RSS إلى بقية المنصات.
  • إيقاف ويب-هوك نشاط حساب X: لن يكون إجراء ويب-هوك نشاط حساب X (accountActivity) متاحًا بعد 31 مارس 2026. يشمل ذلك جميع إشعارات الأحداث اللحظية لحسابات X المرتبطة (المنشورات، الإشارات، الرسائل المباشرة، الإعجابات، المتابعات، الحظر، إلخ).
​
14 نوفمبر 2025
  • اعتبارًا من 14 نوفمبر 2025، سيوقف فيسبوك الحقول التالية عن GET analytics/social:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → انتقل إلى pageMediaView
    • pageImpressionsPaidUnique → انتقل إلى pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → انتقل إلى pageMediaViewIsFromAds
  • اعتبارًا من 14 نوفمبر 2025، سيوقف فيسبوك الحقول التالية عن GET analytics/post:
    • impressions وimpressionsFanPaidUnique → انتقل إلى mediaView. التفصيل المتاح عبر mediaViewIsFromAds (المشاهدات المنسوبة للإعلانات) وmediaViewIsFromFollowers (المشاهدات المنسوبة للمتابعين).
    • postImpressionsUnique (Reels) → استخدم blueReelsPlayCount لعدد تشغيلات Reels أو postVideoViewTime لإجمالي وقت المشاهدة.
​
1 سبتمبر 2025
  • اعتبارًا من 1 سبتمبر 2025، لن تتضمن نقطة نهاية الحصول على التعليقات لإنستجرام الحقل text في كائنات الرد. استخدم الحقل comment بدلًا منه للوصول إلى محتوى الرد.
​
1 يونيو 2025
  • ستنقل نقطة نهاية الحصول على التعليقات في X (تويتر) مقاييس المستخدم العامة إلى كائن publicMetrics الجديد. ستُنقل الحقول التالية من المستوى الأعلى إلى كائن publicMetrics:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • سيوقف فيسبوك الحقول التالية عن GET analytics/social:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
7 مايو 2025
  • أوقف YouTube إعداد المناطق المسموح بها والمحظورة. لا يزال بإمكانك إضافة المناطق المسموح بها والمحظورة إلى نقطة نهاية النشر، لكنها ستُتجاهل.
​
20 أبريل 2025
​
1 مارس 2025
ستوحّد نقطة نهاية الحصول على التعليقات لـ TikTok أسماء الحقول لتتوافق مع بقية شبكات التواصل الاجتماعي.
  • سيُعاد تسمية الحقل replyList إلى replies وprofileImage إلى profileImageUrl.
  • كلا الاسمين الجديدين للحقلين متاحان بالفعل ويمكن استخدامهما في تكاملك.
  • يشمل TikTok التحديثات التالية:
    • نقطة نهاية التحليلات الاجتماعية: التغييرات التالية قادمة: • سيُوقف حقل durationAverage ويُزال. • نظرًا لقيود API الخاصة بـ TikTok، ستُعيد الحقول shareCountTotal وviewCountTotal وcommentCountTotal الآن إجماليات آخر 60 يومًا فقط بدلًا من الإجماليات الكلية. • لبدء استخدام إجماليات الـ 60 يومًا الآن، أضف period60Days: true إلى جسم طلب API. ملاحظة: استخدام هذا المعامل سيحسّن أوقات الاستجابة بشكل ملحوظ.
    • نقطتا نهاية منصة السجل وتحليلات المنشور: ستُزال الحقول غير الموثّقة caption وcomments وshares وlikes وshareUrl وitemsId — ينبغي استخدام الحقول post وcommentsCount وsharesCount وlikesCount وpostUrl وid بدلًا منها.
​
1 فبراير 2025
ستُغير نقطة نهاية /user طريقة الإبلاغ عن استخدام API:
  • سيتم توسيع حقل monthlyApiCalls ليحصي جميع مكالمات API (المنشورات والتعليقات والتحليلات وغيرها).
  • لعدّ المنشورات تحديدًا، استخدم الحقل الجديد monthlyPostCount.
  • سيُوقف حقل monthlyApiCallsQuota ويُستبدل بحقل monthlyPostQuota الجديد.
​
5 يناير 2025
​
15 ديسمبر 2024
  • لتعزيز الأمن، سنمنع استخدام Profile Keys كمفاتيح API. إذا حاولت استخدام Profile Key بدلًا من مفتاح API، فسيُعيد النظام خطأً. انظر هنا لكيفية استخدام Profile Key بشكل صحيح.
​
15 نوفمبر 2024
  • حدّثنا كيفية الإبلاغ عن أخطاء ويب-هوك TikTok المجدولة. ستظهر هذه الأخطاء الآن في مصفوفة الأخطاء، بما يتوافق مع معالجتنا للأخطاء لأنواع ويب-هوك المجدولة الأخرى. ملاحظة: ستستمر إعادة أخطاء المستوى الأعلى الحالية، لكن نشجّع على استخدام مصفوفة الأخطاء.
  • ستُعيد نقطة نهاية السجل الاستجابات ككائنات افتراضيًا. سيُضبط معامل objResponse على true تلقائيًا.
  • ستُعيد Get All History لـ LinkedIn مصفوفة لكائن mediaUrls. كان يُعاد كائن سابقًا إن كان هناك عنصر وسائط واحد ومصفوفة إن كانت عدة عناصر. الآن ستُعاد مصفوفة دائمًا حتى إن كان عنصر وسائط واحدًا. إن احتجت السلوك السابق، يمكنك استخدام معامل الاستعلام objResponse: false.
​
7 أكتوبر 2024
  • لن تُعيد نقطة نهاية media الحقل url_1080 بعد الآن. إن احتجت إلى تغيير حجم صورة، يُرجى الاطلاع على نقطة نهاية resize.
​
16 سبتمبر 2024
​
3 يونيو 2024
​
22 أبريل 2024
  • ستوقف Meta واجهة Facebook Groups API. يُرجى الاطلاع على الإعلان.
​
16 أبريل 2024
  • وضّح إنستجرام الفترة الزمنية لبيانات المتابعين المتصلين. يُرجى الاطلاع هنا على التفاصيل.
​
1 أبريل 2024
  • الرد على تعليق بمعرّف التعليق استجابته الافتراضية ستكون كائنًا كما هو مذكور في الوثائق بدلًا من مصفوفة. يمكنك استخدام معامل objResponse مضبوطًا على قيمة منطقية false إن رغبت في الاحتفاظ باستجابة كمصفوفة.
​
25 يناير 2024
​
8 ديسمبر 2023
  • حقول نقطة نهاية /history/instagram: caption وmessage وcreatedTime وtimestamp أُوقفت في 1 أبريل 2023 وستُزال. يُرجى استخدام الحقلين post و created.
  • حقل mediaUrls في نقطة نهاية /history/linkedin سيُعاد كمصفوفة بدلًا من كائن لدعم عدة صور. يمكنك فرض إعادة مصفوفة الآن بتضمين معامل استعلام LinkedIn ?multiMedia=true. يُرجى ملاحظة أنه قبل 1 ديسمبر 2023 يجب استخدام معامل الاستعلام multiMedia لإعادة الوسائط ذات الصور المتعددة. بعد 1 ديسمبر 2023 ستُعاد الصور المتعددة افتراضيًا.
  • ويب-هوك Scheduled Action لـ TikTok سيُوقف السلسلة النصية platform. يُرجى استخدام حقل مصفوفة platforms كما يحدث لأنواع ويب-هوك Scheduled Action الأخرى.
  • تم تصحيح وثائق حذف التعليق لتتوافق مع الإرجاع الصحيح.
  • سيُستبدل حقل commentId في TikTok بحقل id ليتوافق مع التنسيق القياسي لحذف التعليق.
  • لن يحتوي إرجاع حذف تعليق تويتر على مصفوفة posts ليتوافق الإرجاع مع التنسيق القياسي لحذف التعليق. الإرجاع الجديد سيكون كما يلي:
​
18 أكتوبر 2023
​
30 مايو 2023
  • قمنا بالترقية إلى الإصدار 2 الجديد من Twitter API. أوقف Twitter عدة حقول في الإصدار 2، مما يؤثر على نقاط نهاية /analytics/social وgetAllHistory. ستستمر إعادة هذه الحقول التالية حتى 1 سبتمبر 2023، لكنها ستحمل قيمة صفرية أو سلسلة فارغة.
​
8 مايو 2023
  • يسعدنا إطلاق النشر المباشر على TikTok، وإدارة التعليقات، والتحليلات المتقدمة. لن يحتاج مستخدموك بعد الآن إلى فتح تطبيق TikTok على الهاتف للنشر وإدخال نص التسمية التوضيحية. الآن بعد الإرسال عبر Ayrshare، يُنشر فيديو TikTok والتسمية التوضيحية مباشرةً.
  • كما نقدّم إضافة تعليقات TikTok والحصول عليها وحذفها + بيانات التحليلات الديموغرافية.
  • سيحتاج مستخدمك إلى فصل حساب TikTok وإعادة ربطه لتفعيل النشر المباشر. ستستمر الاتصالات الحالية بالطريقة غير المباشرة وستتطلب تطبيق TikTok على الهاتف للنشر.
​
17 فبراير 2023
  • غيّر Google Business Profile بيانات التحليلات الاجتماعية المتاحة. الحقول الجديدة المتاحة هي التالية. ستظل الحقول السابقة موجودة لكن بقيمة صفرية وستُزال بالكامل في 17 مارس 2023.
​
1 أكتوبر 2022
  • تم توحيد حقول أوصاف Get All Posts والنص والرسالة إلى حقل post.
​
12 سبتمبر 2022
  • حقول TikTok المُوقفة: shareUrl. استخدم postUrl بدلًا منه.
​
17 يونيو 2022
  • لجميع نقاط نهاية السجل، ستُستبدل الحقول createdAt وcreatedTime وtimestamp بالحقل created الذي يُعيد وقت الإنشاء بتنسيق UTC.
  • لن يُعيد حقل scheduleDate كائنًا بل سلسلة نصية تحتوي على وقت الجدولة بتنسيق UTC.
  • سيُزال حقل created_date غير الموثّق في /history. استخدم created بدلًا منه.
​
22 أبريل 2022
  • تُعيد التحليلات على منشور فيسبوك الحقل reactions ككائن بالتنسيق التالي.
​
1 أبريل 2022
  • سيُعيد السجل افتراضيًا آخر 20 منشورًا. يمكن إعادة ما يصل إلى 500 عبر معامل lastRecords.