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

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

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

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

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

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

إصدار واجهة برمجة التطبيقات تاريخ الإصدار تاريخ الإيقاف النهائي التغييرات التي قد تؤدي إلى أعطال والترقية الميزات والتحديثات جدول الاختلافات في Proto
نُسخ الإصدارات التي تم طرحها
v23 ‫28 يناير 2026 فبراير 2027 التغييرات التي قد تؤدي إلى عطل في الإصدار 23 (دليل الترقية) ميزات الإصدار 23 وتحديثاته v22 versus v23 proto diffs
v23.1 ‫25 فبراير 2026 فبراير 2027 لا شيء (إصدار ثانوي) الميزات والتحديثات في الإصدار 23.1 v22 versus v23 proto diffs
v23.2 ‫25 مارس 2026 فبراير 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 23.2 وتحديثاته v22 versus v23 proto diffs
v23.3 ‫24 يونيو 2026 فبراير 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 23.3 وتحديثاته v22 versus v23 proto diffs
v24 ‫22 أبريل 2026 أيار (مايو) 2027 التغييرات التي قد تؤدي إلى عطل في الإصدار 24 (دليل الترقية) ميزات الإصدار 24 وتحديثاته الاختلافات بين الإصدار 23 والإصدار 24 من proto
v24.1 ‫13 مايو 2026 أيار (مايو) 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 24.1 وتحديثاته الاختلافات بين الإصدار 23 والإصدار 24 من proto
v24.2 ‫24 يونيو 2026 يونيو 2027 لا شيء (إصدار ثانوي) الميزات والتعديلات في الإصدار 24.2 الاختلافات بين الإصدار 23 والإصدار 24 من proto
v25 ‫22 يوليو 2026 أغسطس 2027 التغييرات التي قد تؤدي إلى عطل في الإصدار 25 (دليل الترقية) ميزات الإصدار 25 وتحديثاته v24 versus v25 proto diffs
v25.1 ‫19 أغسطس 2026 أغسطس 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 25.1 وتحديثاته v24 versus v25 proto diffs
v25.2 ‫23 سبتمبر 2026 أغسطس 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 25.2 وتحديثاته v24 versus v25 proto diffs
v26 (الأحدث) ‫14 أكتوبر 2026 نوفمبر 2027 التغييرات التي قد تؤدي إلى عطل في الإصدار 26 (دليل الترقية) ميزات الإصدار 26 وتحديثاته الاختلافات بين الإصدار 25 والإصدار 26 من بروتوكول proto
v26.1 ‫28 أكتوبر 2026 نوفمبر 2027 لا شيء (إصدار ثانوي) ميزات الإصدار 26.1 وتحديثاته الاختلافات بين الإصدار 25 والإصدار 26 من بروتوكول proto
الإصدارات القادمة
v26.2 نوفمبر 2026 نوفمبر 2027      
الإصدار 26.3* ديسمبر 2026 نوفمبر 2027      
v27 يناير 2027 شباط (فبراير) 2028      
v27.1 فبراير 2027 شباط (فبراير) 2028      
v27.2 فبراير 2027 شباط (فبراير) 2028      
v27.3 مارس 2027 شباط (فبراير) 2028      
v27.4 مارس 2027 شباط (فبراير) 2028      
v28 أبريل 2027 أيار (مايو) 2028      
v28.1 أبريل 2027 أيار (مايو) 2028      
v28.2 أيار (مايو) 2027 أيار (مايو) 2028      
v28.3 أيار (مايو) 2027 أيار (مايو) 2028      
v28.4 يونيو 2027 أيار (مايو) 2028      
v28.5 يونيو 2027 أيار (مايو) 2028      
v29 تموز (يوليو) 2027 أغسطس 2028      
v29.1 تموز (يوليو) 2027 أغسطس 2028      
v29.2 أغسطس 2027 أغسطس 2028      
v29.3 أغسطس 2027 أغسطس 2028      
v29.4 سبتمبر 2027 أغسطس 2028      
v29.5 سبتمبر 2027 أغسطس 2028      
v30 تشرين الأول (أكتوبر) 2027 تشرين الثاني (نوفمبر) 2028      
v30.1 تشرين الأول (أكتوبر) 2027 تشرين الثاني (نوفمبر) 2028      
v30.2 نوفمبر 2027 تشرين الثاني (نوفمبر) 2028      
الإصدار 30.3* ديسمبر 2027 تشرين الثاني (نوفمبر) 2028      

* يُعدّ الإصداران 26.3 و30.3 إصدارَين اختياريَين بسبب تداخلهما مع موسم الأعياد.

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

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

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

الاختلافات بين الإيقاف النهائي والإيقاف التدريجي

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

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

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

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

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

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

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

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

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

جافا

سجلّ التغييرات

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

#C

سجلّ التغييرات

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

PHP

سجلّ التغييرات

مكتبة برامج PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

سجلّ التغييرات

مكتبة برامج Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

سجلّ التغييرات

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

Perl

سجلّ التغييرات

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

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

While this page focuses on API version-level lifecycles, individual feature deprecations (such as the deprecation of Smart Campaigns) and unversioned workflow changes (such as new Demand Gen campaign budget requirements) are tracked separately.

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