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

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

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

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

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

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

إصدار واجهة برمجة التطبيقاتتاريخ الإصدارتاريخ الإيقاف النهائيدليل الترقية
الإصدارات التي تم طرحها
v20‫4 يونيو 2025‫10 يونيو 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 ‫22 أبريل 2026 مايو 2027 الترقية من الإصدار 23.2 إلى الإصدار 24
v24.1 ‫13 مايو 2026 مايو 2027 الترقية من الإصدار 24 إلى الإصدار 24.1
الإصدارات القادمة
v24.2 يونيو 2026 مايو 2027  
v25 يوليو 2026 أغسطس 2027  
v25.1 أغسطس 2026 أغسطس 2027  
v25.2 سبتمبر 2026 أغسطس 2027  
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.v24.services.GoogleAdsService.Mutate.
  4. (اختياري) اختَر الفترة الزمنية التي تريد عرض طلباتك فيها.

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

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

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

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

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

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

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

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

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

جافا

مكتبة برامج Java
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: 42.2.0

#C

مكتبة برامج ‎ .NET
v24 Min: 25.3.0
Max: -
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
v24 Min: 33.3.0
Max: -
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
v24 Min: 30.1.0
Max: -
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
v24 Min: 40.0.0
Max: -
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
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: 32.0.0

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
تغيير سياسة الاحتفاظ بالبيانات سيتم خفض فترة التخزين لبيانات التقارير الدقيقة (اليومية والساعية والأسبوعية) إلى 37 شهرًا. تبقى البيانات العامة (الشهرية أو الربع سنوية أو السنوية) متاحة لمدة 11 عامًا. ‫1 يونيو 2026 يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
تغييرات على إتاحة ميزة "الإحالات الناجحة غير الإلكترونية"

اعتبارًا من 15 يونيو 2026، يجب أن تستخدم رموز المطوّرين التي لم تتضمّن أي طلبات حديثة للإحالات الناجحة غير الإلكترونية واجهة Data Manager API لسير عمل الإحالات الناجحة غير الإلكترونية.

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

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