> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# تغييرات API القادمة

> تغييرات على واجهة API قد تؤثر على تكاملك

ستدخل التغييرات التالية على واجهة API حيّز التنفيذ في التاريخ المحدد.
يُرجى المراجعة بعناية لأي تغييرات محتملة تُحدث كسرًا (breaking changes).
انظر [ما الجديد](/whatsnew/latest) لجميع الميزات الجديدة.

<Update label="15 يونيو 2026">
  <ul class="custom-bullets">
    <li>
      **فيسبوك: أوقفت Meta مقاييس Insights للانطباعات الفريدة (reach) ومشاهدات الفيديو لمدة 3 ثوانٍ.** أزالت Meta هذه المقاييس عبر جميع إصدارات Graph API، لذا لم تعد الحقول المتأثرة تُعاد. انظر [سجل تغييرات Meta Graph API v25](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) للتفاصيل.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) لم يعد يُعيد حقول فيسبوك التالية:

          <ul class="custom-bullets">
            <li>impressionsUnique → انتقل إلى `mediaView`</li>
            <li>impressionsFanUnique → انتقل إلى `mediaView`</li>
            <li>impressionsOrganicUnique → انتقل إلى `mediaView`</li>
            <li>impressionsPaidUnique → انتقل إلى `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → استخدم `videoViews` لمشاهدات الـ 3 ثوانٍ غير الفريدة</li>
            <li>عائلتا `totalVideoViews*Unique` و`totalVideoImpressions*` (مثل `totalVideoViewsOrganicUnique` و`totalVideoViewsPaidUnique` و`totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) لم يعد يُعيد حقول فيسبوك التالية:

          <ul class="custom-bullets">
            <li>عائلة `pagePostsImpressions*` (`pagePostsImpressions` و`pagePostsImpressionsPaid` و`pagePostsImpressionsUnique` و`pagePostsImpressionsOrganicUnique` و`pagePostsImpressionsViral*` و`pagePostsImpressionsNonviral*`) → انتقل إلى `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → انتقل إلى `pageMediaView`</li>
            <li>pageVideoViewsUnique → استخدم `pageVideoViews` لمشاهدات الـ 3 ثوانٍ غير الفريدة</li>
          </ul>
        </li>

        <li>
          استخدم `mediaView` / `pageMediaView` للـ reach. ثمة مقياس بديل لإجمالي مشاهدات الوسائط الفريدة قيد التخطيط. الحقول التي لا تزال مدعومة مثل `reactionsByType` و`videoViews` و`mediaView` و`pagePostEngagements` و`pageVideoViews` و`pageVideoViewsPaid` لم تتأثر.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11 مايو 2026">
  <ul class="custom-bullets">
    <li>
      **إخفاقات YouTube المؤقتة تُعيد الآن HTTP 503/504 بدلًا من 500:** بعض إخفاقات رفع YouTube التي كانت تظهر سابقًا بـ HTTP 500 (`code: 176`) تُعيد الآن HTTP 503 (`code: 454`) أو HTTP 504 (`code: 453`). تتضمن كلتا الاستجابتين `retryAvailable: true`. تكاملات العملاء التي تعتمد على HTTP 500 لإعادة محاولة رفع YouTube ينبغي أن تنتقل إلى الاعتماد على حقل `retryAvailable` في جسم الاستجابة. انظر [أكواد الأخطاء](/errors/errors-ayrshare) للتفاصيل.
    </li>
  </ul>
</Update>

<Update label="9 أبريل 2026">
  <ul class="custom-bullets">
    <li>
      **التحليلات الفارغة تُعيد الخطأ 187:** طلب [التحليلات الاجتماعية](/apis/analytics/social) أو [تحليلات المنشور](/apis/analytics/post) عندما لا تُعيد أي منصة بيانات يُعيد الآن `{ "status": "error", "code": 187 }` بدلًا من `{ "status": "success" }`. حدّث أي شيفرة عميل تعتمد على سلوك النجاح الفارغ السابق.
    </li>
  </ul>
</Update>

<Update label="31 مارس 2026">
  <ul class="custom-bullets">
    <li>
      **متطلب مفتاح BYO لـ X/Twitter:** ستتطلب جميع عمليات X/Twitter عبر Ayrshare بيانات اعتماد API الخاصة بك. بعد ربط حساب X عبر OAuth، ضمّن ترويستَين في كل طلب X/Twitter: `X-Twitter-OAuth1-Api-Key` و`X-Twitter-OAuth1-Api-Secret`. سيتم رفض الطلبات التي لا تحمل بيانات اعتماد صالحة. انظر [دليل إعداد مفتاح X BYO](/dashboard/connect-social-accounts/x-twitter-byo-keys) للتعليمات.
    </li>

    <li>
      **إيقاف RSS إلى X:** لن يتم دعم النشر التلقائي عبر RSS إلى X/Twitter بعد 31 مارس 2026. تعمل تغذيات RSS وفق جدول دون بيانات اعتماد لكل طلب، وهو غير متوافق مع نموذج BYO للمفاتيح. لا يتأثر النشر التلقائي عبر RSS إلى بقية المنصات.
    </li>

    <li>
      **إيقاف ويب-هوك نشاط حساب X:** لن يكون إجراء ويب-هوك نشاط حساب X (`accountActivity`) متاحًا بعد 31 مارس 2026. يشمل ذلك جميع إشعارات الأحداث اللحظية لحسابات X المرتبطة (المنشورات، الإشارات، الرسائل المباشرة، الإعجابات، المتابعات، الحظر، إلخ).
    </li>
  </ul>
</Update>

<Update label="14 نوفمبر 2025">
  <ul class="custom-bullets">
    <li>
      اعتبارًا من 14 نوفمبر 2025، سيوقف فيسبوك الحقول التالية عن [GET analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageFans</li>
        <li>pageFansCity</li>
        <li>pageFansLocale</li>
        <li>pageFansCountry</li>
        <li>pageFansAdds</li>
        <li>pageFanAddsUnique</li>
        <li>pageFanRemoves</li>
        <li>pageFanRemovesUnique</li>
        <li>pageImpressions → انتقل إلى `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → انتقل إلى `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → انتقل إلى `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      اعتبارًا من 14 نوفمبر 2025، سيوقف فيسبوك الحقول التالية عن [GET analytics/post](/apis/analytics/post):

      <ul class="custom-bullets">
        <li>impressions وimpressionsFanPaidUnique → انتقل إلى `mediaView`. التفصيل المتاح عبر `mediaViewIsFromAds` (المشاهدات المنسوبة للإعلانات) و`mediaViewIsFromFollowers` (المشاهدات المنسوبة للمتابعين).</li>
        <li>postImpressionsUnique (Reels) → استخدم `blueReelsPlayCount` لعدد تشغيلات Reels أو `postVideoViewTime` لإجمالي وقت المشاهدة.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 سبتمبر 2025">
  <ul class="custom-bullets">
    <li>
      اعتبارًا من 1 سبتمبر 2025، لن تتضمن نقطة نهاية [الحصول على التعليقات](/apis/comments/get-comments) لإنستجرام
      الحقل `text` في كائنات الرد. استخدم الحقل `comment`
      بدلًا منه للوصول إلى محتوى الرد.
    </li>
  </ul>
</Update>

<Update label="1 يونيو 2025">
  <ul class="custom-bullets">
    <li>
      ستنقل نقطة نهاية [الحصول على التعليقات](/apis/comments/get-comments) في X (تويتر) مقاييس المستخدم
      العامة إلى كائن `publicMetrics` الجديد. ستُنقل الحقول التالية من المستوى الأعلى إلى
      كائن `publicMetrics`:

      <ul class="custom-bullets">
        <li>followersCount</li>
        <li>followingCount</li>
        <li>tweetCount</li>
        <li>listedCount</li>
        <li>mediaCount</li>
      </ul>
    </li>

    <li>
      سيوقف فيسبوك الحقول التالية عن [GET
      analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageVideoViews10S</li>
        <li>pageVideoViews10SAutoplayed</li>
        <li>pageVideoViews10SClickToPlay</li>
        <li>pageVideoViews10SOrganic</li>
        <li>pageVideoViews10SPaid</li>
        <li>pageVideoViews10SRepeat</li>
        <li>pageVideoViews10SUnique</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="7 مايو 2025">
  <ul class="custom-bullets">
    <li>
      أوقف YouTube إعداد المناطق المسموح بها والمحظورة. لا يزال بإمكانك إضافة المناطق المسموح
      بها والمحظورة إلى نقطة نهاية النشر، لكنها ستُتجاهل.
    </li>
  </ul>
</Update>

<Update label="20 أبريل 2025">
  <ul class="custom-bullets">
    <li>
      ستُوقف المقاييس التالية عن [تحليلات منشور إنستجرام](/apis/analytics/post):

      REELS:

      <ul class="custom-bullets">
        <li>
          playsCount
        </li>

        <li>
          clipsReplaysCount
        </li>

        <li>
          igReelsAggregatedAllPlaysCount
        </li>
      </ul>

      FEED/STORY:

      <ul class="custom-bullets">
        <li>
          impressionsCount
        </li>
      </ul>
    </li>

    <li>
      ستفرض [نقطة نهاية السجل](/apis/history/get-history) التخزين المؤقت لمدة دقيقة واحدة إذا كانت `limit` أكبر من القيمة الافتراضية 25.
    </li>
  </ul>
</Update>

<Update label="1 مارس 2025">
  ستوحّد نقطة نهاية [الحصول على التعليقات](/apis/comments/get-comments) لـ TikTok أسماء الحقول
  لتتوافق مع بقية شبكات التواصل الاجتماعي.

  <ul class="custom-bullets">
    <li>
      سيُعاد تسمية الحقل `replyList` إلى `replies` و`profileImage` إلى
      `profileImageUrl`.
    </li>

    <li>كلا الاسمين الجديدين للحقلين متاحان بالفعل ويمكن استخدامهما في تكاملك.</li>

    <li>
      يشمل TikTok التحديثات التالية:

      <ul class="custom-bullets">
        <li>
          نقطة نهاية [التحليلات الاجتماعية](/apis/analytics/social): التغييرات التالية قادمة:
          • سيُوقف حقل `durationAverage` ويُزال. • نظرًا لقيود API الخاصة بـ TikTok،
          ستُعيد الحقول `shareCountTotal` و`viewCountTotal` و`commentCountTotal`
          الآن إجماليات آخر 60 يومًا فقط بدلًا من الإجماليات الكلية. • لبدء استخدام
          إجماليات الـ 60 يومًا الآن، أضف `period60Days: true` إلى جسم طلب API. ملاحظة: استخدام هذا
          المعامل سيحسّن أوقات الاستجابة بشكل ملحوظ.
        </li>

        <li>
          نقطتا نهاية [منصة السجل](/apis/history/history-platform) و[تحليلات
          المنشور](/apis/analytics/post): ستُزال الحقول غير الموثّقة `caption` و`comments`
          و`shares` و`likes` و`shareUrl` و`itemsId` — ينبغي استخدام الحقول `post`
          و`commentsCount` و`sharesCount` و`likesCount` و`postUrl` و`id` بدلًا منها.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 فبراير 2025">
  ستُغير نقطة نهاية [/user](/apis/user/profile-details) طريقة الإبلاغ عن استخدام API:

  <ul class="custom-bullets">
    <li>
      سيتم توسيع حقل `monthlyApiCalls` ليحصي جميع مكالمات API (المنشورات والتعليقات
      والتحليلات وغيرها).
    </li>

    <li>لعدّ المنشورات تحديدًا، استخدم الحقل الجديد `monthlyPostCount`.</li>

    <li>
      سيُوقف حقل `monthlyApiCallsQuota` ويُستبدل بحقل `monthlyPostQuota`
      الجديد.
    </li>
  </ul>
</Update>

<Update label="5 يناير 2025">
  <ul class="custom-bullets">
    <li>
      توقف Meta حقل `videoViews` على [نقطة نهاية تحليلات منشور
      إنستجرام](/apis/analytics/post).
    </li>

    <li>
      إضافةً إلى ذلك، ستُزال حقول `emailContactsCount` و`getDirectionClicks` و`profileViewsCount`
      و`textMessageClicks` و`websiteClicksCount` و`phoneCallClicksCount`
      من نقطة نهاية [التحليلات الاجتماعية لإنستجرام](/apis/analytics/social).
    </li>

    <li>ستُزال هذه الحقول في 5 يناير 2025.</li>
  </ul>
</Update>

<Update label="15 ديسمبر 2024">
  <ul class="custom-bullets">
    <li>
      لتعزيز الأمن، سنمنع استخدام Profile Keys كمفاتيح API. إذا
      حاولت استخدام Profile Key بدلًا من مفتاح API، فسيُعيد النظام خطأً. [انظر
      هنا](/apis/overview#authorization) لكيفية استخدام Profile Key بشكل صحيح.
    </li>
  </ul>
</Update>

<Update label="15 نوفمبر 2024">
  <ul class="custom-bullets">
    <li>
      حدّثنا كيفية الإبلاغ عن أخطاء ويب-هوك TikTok المجدولة. ستظهر هذه الأخطاء الآن
      في مصفوفة الأخطاء، بما يتوافق مع معالجتنا للأخطاء لأنواع ويب-هوك المجدولة الأخرى.
      ملاحظة: ستستمر إعادة أخطاء المستوى الأعلى الحالية، لكن نشجّع على استخدام مصفوفة
      الأخطاء.
    </li>

    <li>
      ستُعيد نقطة نهاية السجل الاستجابات ككائنات افتراضيًا. سيُضبط معامل objResponse
      على true تلقائيًا.
    </li>

    <li>
      ستُعيد Get All History لـ LinkedIn مصفوفة لكائن mediaUrls. كان يُعاد كائن سابقًا
      إن كان هناك عنصر وسائط واحد ومصفوفة إن كانت عدة عناصر. الآن ستُعاد مصفوفة
      دائمًا حتى إن كان عنصر وسائط واحدًا. إن احتجت السلوك السابق،
      يمكنك استخدام معامل الاستعلام `objResponse: false`.
    </li>
  </ul>
</Update>

<Update label="7 أكتوبر 2024">
  <ul class="custom-bullets">
    <li>
      لن تُعيد نقطة نهاية media الحقل url\_1080 بعد الآن. إن احتجت إلى تغيير حجم صورة، يُرجى
      الاطلاع على [نقطة نهاية resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16 سبتمبر 2024">
  <ul class="custom-bullets">
    <li>
      **تحديث 25 سبتمبر 2024**: أطلقت Meta (فيسبوك) إيقاف الحقول، لذا فإن
      إزالة الحقول سارية. يُرجى الاطلاع على المُعاد المُحدّث في [التحليلات
      الاجتماعية](/apis/analytics/social).
    </li>

    <li>
      سيوقف فيسبوك [عدة حقول](https://developers.facebook.com/docs/pages-api/changelog/).
      لن تُعيد [نقطة نهاية التحليلات الاجتماعية](/apis/analytics/social-by-id) هذه الحقول بعد 16
      سبتمبر 2024.
    </li>
  </ul>
</Update>

<Update label="3 يونيو 2024">
  <ul class="custom-bullets">
    <li>
      سيستبدل [نظام مختصر الروابط المرتبط الجديد](/apis/links/overview) نقطة نهاية المختصر،
      التي أوقفتها Google. يتطلب مختصر الروابط الجديد إضافة [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      سيكون اختصار الروابط مغلقًا (`false`) افتراضيًا. لاختصار الروابط تلقائيًا استخدم
      `shortenLinks: true` في مكالمة نقطة نهاية النشر، والتي تستخدم [نقطة نهاية الروابط](/apis/links/overview)
      الجديدة.
    </li>
  </ul>
</Update>

<Update label="22 أبريل 2024">
  <ul class="custom-bullets">
    <li>
      ستوقف Meta واجهة Facebook Groups API. يُرجى الاطلاع على
      [الإعلان](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16 أبريل 2024">
  <ul class="custom-bullets">
    <li>
      وضّح إنستجرام الفترة الزمنية لبيانات المتابعين المتصلين. يُرجى الاطلاع هنا على
      [التفاصيل](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1 أبريل 2024">
  <ul class="custom-bullets">
    <li>
      [الرد على تعليق بمعرّف التعليق](/apis/comments/reply-to-comment) استجابته الافتراضية ستكون
      كائنًا كما هو مذكور في الوثائق بدلًا من مصفوفة. يمكنك استخدام معامل objResponse مضبوطًا
      على قيمة منطقية `false` إن رغبت في الاحتفاظ باستجابة كمصفوفة.
    </li>
  </ul>
</Update>

<Update label="25 يناير 2024">
  <ul class="custom-bullets">
    <li>
      ستُعيد [نقطة نهاية retry post](/apis/post/retry-post) حالة "pending" بدلًا من
      "success" لتعكس بشكل أفضل حالة إعادة المحاولة.
    </li>

    <li>
      ستُصدر [تغييرات API على scheduleDate و
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022).
    </li>
  </ul>
</Update>

<Update label="8 ديسمبر 2023">
  <ul class="custom-bullets">
    <li>
      حقول نقطة نهاية `/history/instagram`: `caption` و`message` و`createdTime` و`timestamp`
      أُوقفت في 1 أبريل 2023 وستُزال. يُرجى استخدام الحقلين `post` و
      `created`.
    </li>

    <li>
      حقل `mediaUrls` في نقطة نهاية `/history/linkedin` سيُعاد كمصفوفة بدلًا من
      كائن لدعم عدة صور. يمكنك فرض إعادة مصفوفة الآن بتضمين معامل استعلام
      LinkedIn `?multiMedia=true`. يُرجى ملاحظة أنه قبل 1 ديسمبر 2023 يجب استخدام
      معامل الاستعلام `multiMedia` لإعادة الوسائط ذات الصور المتعددة. بعد 1 ديسمبر
      2023 ستُعاد الصور المتعددة افتراضيًا.
    </li>

    <li>
      ويب-هوك Scheduled Action لـ TikTok سيُوقف السلسلة النصية `platform`. يُرجى استخدام
      حقل مصفوفة `platforms` كما يحدث لأنواع ويب-هوك Scheduled Action الأخرى.
    </li>

    <li>تم تصحيح وثائق حذف التعليق لتتوافق مع الإرجاع الصحيح.</li>

    <li>
      سيُستبدل حقل commentId في TikTok بحقل id ليتوافق مع التنسيق القياسي لحذف
      التعليق.
    </li>

    <li>
      لن يحتوي إرجاع حذف تعليق تويتر على مصفوفة `posts` ليتوافق الإرجاع
      مع التنسيق القياسي لحذف التعليق. الإرجاع الجديد سيكون كما يلي:
    </li>
  </ul>
</Update>

<Update label="18 أكتوبر 2023">
  <ul class="custom-bullets">
    <li>
      حقول YouTube التالية في [نقطة نهاية التحليلات الاجتماعية](/apis/analytics/social)
      ستُعاد كقيم رقمية بدلًا من نصية.
    </li>
  </ul>
</Update>

<Update label="30 مايو 2023">
  <ul class="custom-bullets">
    <li>
      قمنا بالترقية إلى الإصدار 2 الجديد من Twitter API. أوقف Twitter عدة حقول في
      الإصدار 2، مما يؤثر على نقاط نهاية /analytics/social وgetAllHistory. ستستمر إعادة
      هذه الحقول التالية حتى 1 سبتمبر 2023، لكنها ستحمل قيمة صفرية أو سلسلة فارغة.
    </li>
  </ul>
</Update>

<Update label="8 مايو 2023">
  <ul class="custom-bullets">
    <li>
      يسعدنا إطلاق [النشر المباشر على TikTok](/apis/post/social-networks/tiktok)، وإدارة
      التعليقات، والتحليلات المتقدمة. لن يحتاج مستخدموك بعد الآن إلى فتح تطبيق TikTok
      على الهاتف للنشر وإدخال نص التسمية التوضيحية. الآن بعد الإرسال عبر Ayrshare، يُنشر
      فيديو TikTok والتسمية التوضيحية مباشرةً.
    </li>

    <li>
      كما نقدّم إضافة تعليقات TikTok والحصول عليها وحذفها + بيانات
      التحليلات الديموغرافية.
    </li>

    <li>
      سيحتاج مستخدمك إلى فصل حساب TikTok وإعادة ربطه لتفعيل النشر المباشر.
      ستستمر الاتصالات الحالية بالطريقة غير المباشرة وستتطلب تطبيق TikTok على الهاتف
      للنشر.
    </li>
  </ul>
</Update>

<Update label="17 فبراير 2023">
  <ul class="custom-bullets">
    <li>
      غيّر Google Business Profile بيانات التحليلات الاجتماعية المتاحة. الحقول الجديدة
      المتاحة هي التالية. ستظل الحقول السابقة موجودة لكن بقيمة صفرية وستُزال بالكامل
      في 17 مارس 2023.
    </li>
  </ul>
</Update>

<Update label="1 أكتوبر 2022">
  <ul class="custom-bullets">
    <li>تم توحيد حقول أوصاف Get All Posts والنص والرسالة إلى حقل `post`.</li>
  </ul>
</Update>

<Update label="12 سبتمبر 2022">
  <ul class="custom-bullets">
    <li>حقول TikTok المُوقفة: `shareUrl`. استخدم `postUrl` بدلًا منه.</li>
  </ul>
</Update>

<Update label="17 يونيو 2022">
  <ul class="custom-bullets">
    <li>
      لجميع نقاط نهاية السجل، ستُستبدل الحقول `createdAt` و`createdTime` و`timestamp`
      بالحقل `created` الذي يُعيد وقت الإنشاء بتنسيق UTC.
    </li>

    <li>
      لن يُعيد حقل `scheduleDate` كائنًا بل سلسلة نصية تحتوي على وقت الجدولة
      بتنسيق UTC.
    </li>

    <li>
      سيُزال حقل `created_date` غير الموثّق في /history. استخدم `created` بدلًا منه.
    </li>
  </ul>
</Update>

<Update label="22 أبريل 2022">
  <ul class="custom-bullets">
    <li>
      تُعيد التحليلات على [منشور فيسبوك](/apis/analytics/post) الحقل `reactions` ككائن
      بالتنسيق التالي.
    </li>
  </ul>
</Update>

<Update label="1 أبريل 2022">
  <ul class="custom-bullets">
    <li>
      سيُعيد السجل افتراضيًا آخر 20 منشورًا. يمكن إعادة ما يصل إلى 500 عبر معامل
      `lastRecords`.
    </li>
  </ul>
</Update>