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

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

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

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

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

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

إصدار واجهة برمجة التطبيقاتتاريخ الإصدارتاريخ الإيقاف النهائيدليل الترقية
الإصدارات التي تم طرحها
v20‫4 يونيو 2025يونيو 2026 (تاريخ مبدئي)الترقية من الإصدار 19 إلى الإصدار 20
v20.1‫6 أغسطس 2025يونيو 2026 (تاريخ مبدئي)الترقية من الإصدار 19 إلى الإصدار 20
v21‫6 أغسطس 2025أغسطس 2026 (تاريخ مبدئي)الترقية من الإصدار 20 إلى الإصدار 21
v22‫15 أكتوبر 2025أكتوبر 2026 (تاريخ مبدئي)الترقية من الإصدار 21 إلى الإصدار 22
v23‫28 يناير 2026فبراير 2027الترقية من الإصدار 22 إلى الإصدار 23
الإصدارات القادمة
v23.1 ‫25 فبراير 2026 فبراير 2027  
v23.2 ‫25 مارس 2026 فبراير 2027  
v24 أبريل 2026 مايو 2027  
v24.1 أيار (مايو) 2026 مايو 2027  
v24.2 حزيران (يونيو) 2026 مايو 2027  
v25 يوليو 2026 أغسطس 2027  
v25.1 أغسطس 2026 أغسطس 2027  
v25.2 سبتمبر 2026 أغسطس 2027  
v26 تشرين الأول (أكتوبر) 2026 نوفمبر 2027  
‫v26.1* نوفمبر 2026 نوفمبر 2027  

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

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

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

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

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

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

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

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

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

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

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

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

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

جافا

مكتبة برامج Java
v23 Min: 42.1.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

#C

مكتبة برامج ‎ .NET
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

مكتبة برامج للغة PHP
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

مكتبة برامج Python
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

مكتبة برامج Ruby
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

مكتبة برامج Perl
v23 Min: 30.1.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

الميزات التي سيتم إيقافها نهائيًا

ننصحك بمتابعة مدونة مطوّري البرامج على "إعلانات Google" بانتظام لتكون أول من يعلم بشأن إيقاف الميزات القادمة نهائيًا.

يسرد الجدول التالي عمليات إيقاف الميزات المحدّدة التي تم التخطيط لها في Google Ads API. يمكنك الاطّلاع على مزيد من التفاصيل حول كل عملية إيقاف نهائي في مشاركات المدوّنة المرتبطة.

الميزة الوصف تاريخ السريان ملاحظات إضافية
التغييرات على توافق بيانات عنوان IP وسمة الجلسة اعتبارًا من 2 فبراير 2026، لن تقبل Google Ads API أي مستخدمين جدد لسِمات الجلسة أو بيانات عنوان IP كجزء من عمليات استيراد الإحالات الناجحة. على المستخدمين الحاليين نقل البيانات إلى Data Manager API. ‫2 فبراير 2026 يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
إيقاف "الإعلانات للاتصال فقط" نهائيًا اعتبارًا من يناير 2026، لن يكون من الممكن إنشاء إعلانات جديدة للاتصال فقط. سيتوقّف عرض "الإعلانات للاتصال فقط" الحالية في فبراير 2027، وستتم إزالة إمكانية استخدام واجهة برمجة التطبيقات. على المعلِنين استخدام "الإعلانات المتجاوبة على شبكة البحث" التي تتضمّن مواد عرض المكالمات بدلاً من ذلك. يناير 2026 يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.