الإيقاف النهائي

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

  • نسعى جاهدين لإتاحة خمسة إصدارات رئيسية كحدّ أقصى في أي وقت.
  • تبلغ مدة صلاحية الإصدارات الرئيسية حوالي 12 شهرًا، أما الإصدارات الثانوية فتبلغ 10 أشهر.
  • عليك إجراء ترقيتَين كحدّ أقصى في السنة، وليس عليك إجراء الترقية بترتيب تسلسلي صارم، فيمكنك مثلاً الترقية من الإصدار (N) مباشرةً إلى الإصدار (N+2).

تتوافق مكتبات البرامج مع أي إصدارات متاحة من الخدمة، ما يتيح لك الترقية تدريجيًا من خلال تحديد إصدارات مختلفة من الخدمات المستخدَمة.

جدول المواعيد

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

إصدار واجهة برمجة التطبيقاتتاريخ الإصدارتاريخ الإيقاف النهائيدليل الترقية
الإصدارات التي تم طرحها
v22‫15 أكتوبر 2025أكتوبر 2026 (تاريخ مبدئي)الترقية من الإصدار 21 إلى الإصدار 22
v23‫28 يناير 2026فبراير 2027الترقية من الإصدار 22 إلى الإصدار 23
v23.1 ‫25 فبراير 2026 فبراير 2027 الترقية من الإصدار 23 إلى الإصدار 23.1
v23.2 ‫25 مارس 2026 فبراير 2027 الترقية من الإصدار 23.1 إلى الإصدار 23.2
v24 ‫22 أبريل 2026 مايو 2027 الترقية من الإصدار 23.2 إلى الإصدار 24
v24.1 ‫13 مايو 2026 مايو 2027 الترقية من الإصدار 24 إلى الإصدار 24.1
v24.2 ‫24 يونيو 2026 يونيو 2027 الترقية من الإصدار 24.1 إلى الإصدار 24.2
v25 ‫22 يوليو 2026 أغسطس 2027 الترقية من الإصدار 24.2 إلى الإصدار 25
v25.1 ‫19 أغسطس 2026 أغسطس 2027 الترقية من الإصدار 25 إلى الإصدار 25.1
v25.2 ‫23 سبتمبر 2026 أغسطس 2027 الترقية من الإصدار 25.1 إلى الإصدار 25.2
الإصدارات القادمة
v26 تشرين الأول (أكتوبر) 2026 نوفمبر 2027  
الإصدار 26.1* نوفمبر 2026 نوفمبر 2027  

* تم تصنيف الإصدار 26.1 كإصدار اختياري بسبب تداخله مع موسم العطلات.

عرض الإصدارات التي يستخدمها مشروعك

يمكنك الاطّلاع على قائمة بالطُرق والخدمات التي طلبها مشروعك مؤخرًا باستخدام Google Cloud Console:

  1. افتح واجهات برمجة التطبيقات والخدمات في Google Cloud Console.
  2. انقر على Google Ads API في الجدول.
  3. في علامة التبويب الفرعية المقاييس، من المفترض أن تظهر طلباتك الأخيرة على كل رسم بياني. يمكنك الاطّلاع على الطرق التي أرسلت إليها الطلبات في جدول الطرق. يتضمّن اسم الطريقة إصدارًا من Google Ads API وخدمة واسم طريقة، مثل google.ads.googleads.v25.services.GoogleAdsService.Mutate.
  4. (اختياري) اختَر الفترة الزمنية التي تريد عرضها لطلباتك.

الاختلافات بين الإيقاف النهائي والإيقاف المؤقت

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

ننصحك بالترقية إلى أحدث إصدار في أقرب وقت ممكن للاستفادة من الميزات الجديدة.

 يجب الترقية من الإصدارات التي سيتم إيقافها على الفور من أجل استخدام Google Ads API.

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

يمكنك الوصول إلى نقاط نهاية واجهة برمجة التطبيقات باستخدام مكتبات العملاء وREST. ومع ذلك، لا تتم إضافة ميزات جديدة إلى الإصدارات المتوقّفة نهائيًا.

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

إصدارات مكتبة البرامج المتوافقة

يوضّح الجدول مكتبات البرامج التي تتوافق مع إصدارات واجهة برمجة التطبيقات.

إنّ الحدّ الأدنى لإصدار مكتبة البرامج المُدرَج كافٍ لإصدار Google Ads API الرئيسي (مثل الإصدار 25). للاطّلاع على إصدار مكتبة البرامج المطلوب للإصدارات الثانوية، يُرجى الرجوع إلى سجلّ التغيير المرتبط.

جافا

سجلّ التغيير

مكتبة برامج Java
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -

#C

سجلّ التغيير

مكتبة برامج ‎ .NET
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -

PHP

سجلّ التغيير

مكتبة برامج للغة PHP
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -

Python

سجلّ التغيير

مكتبة برامج Python
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: 32.0.0

Ruby

سجلّ التغيير

مكتبة برامج Ruby
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -

Perl

سجلّ التغيير

مكتبة برامج Perl
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -

إيقاف الميزات نهائيًا وإجراء تغييرات عليها

في حين تركّز هذه الصفحة على دورات الحياة على مستوى إصدار واجهة برمجة التطبيقات، يتم تتبُّع عمليات إيقاف الميزات الفردية نهائيًا (مثل إيقاف "الحملات الذكية" نهائيًا) والتغييرات في سير العمل غير المرتبطة بإصدار (مثل متطلبات ميزانية "حملات زيادة الطلب" الجديدة) بشكل منفصل.

للاطّلاع على دورات حياة الميزات القادمة والتغييرات السلوكية في جميع الإصدارات النشطة، راجِع دليل إيقاف الميزات نهائيًا والتغييرات غير المرتبطة بإصدار.