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

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

  • نسعى إلى إبقاء أربعة إصدارات رئيسية على الأكثر متاحة في أي وقت.
  • يبلغ عمر إصدارات 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 الترقية من الإصدار 23 إلى الإصدار 23.1
v23.2 ‫25 مارس 2026 فبراير 2027 الترقية من الإصدار 23.1 إلى الإصدار 23.2
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: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
التغييرات على ميزة "مطابقة العملاء"

اعتبارًا من 1 أبريل 2026، يجب أن تستخدم رموز المطوّرين التي لم تتضمّن طلبات حديثة لميزة "مطابقة العملاء" واجهة Data Manager API في سير عمل ميزة "مطابقة العملاء".

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