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

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

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

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

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

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

إصدار واجهة برمجة التطبيقاتتاريخ الإصدارتاريخ الإيقاف النهائيتاريخ الإيقاف النهائيدليل الترقية
v21‫6 أغسطس 2025الترقية من الإصدار 20 إلى الإصدار 21
v20.1‫6 أغسطس 2025يونيو 2026 (تاريخ مبدئي)الترقية من الإصدار 19 إلى الإصدار 20
v20‫4 يونيو 2025يونيو 2026 (تاريخ مبدئي)الترقية من الإصدار 19 إلى الإصدار 20
v19.2‫6 أغسطس 2025 فبراير 2026 (تاريخ مبدئي)الترقية من الإصدار 18 إلى الإصدار 19
v19.1‫16 أبريل 2025 فبراير 2026 (تاريخ مبدئي)الترقية من الإصدار 18 إلى الإصدار 19
v19‫26 فبراير 2025 فبراير 2026 (تاريخ مبدئي)الترقية من الإصدار 18 إلى الإصدار 19
v1816 أكتوبر 2024يونيو 2025‫20 أغسطس 2025

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

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

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

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

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

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

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

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

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

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

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

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

Java

مكتبة برامج Java
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

#C

مكتبة برامج لنظام ‎NET.
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

مكتبة برامج للغة PHP
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

مكتبة برامج Python
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

مكتبة برامج Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

مكتبة برامج Perl
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
بيئة الإحالة الناجحة التي تؤثّر في أداء "حملات التطبيقات" اعتبارًا من 30 سبتمبر 2025، سنبدأ تدريجيًا بطرح تغيير على نماذج عروض الأسعار، ما يتيح لها استخدام بيانات بيئة الإحالة الناجحة المضمّنة في الإحالات الناجحة المستورَدة لتحسين أداء الحملة. ‫3 أكتوبر 2025 يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
يمكن أن تتضمّن الإحالات الناجحة قيمتَي `gclid` و `gbraid`. اعتبارًا من 3 أكتوبر 2025، لن تعرض الإحالات الناجحة المستورَدة الخطأ `VALUE_MUST_BE_UNSET` إذا تم ضبط الحقلَين `gclid` و `gbraid`. ‫3 أكتوبر 2025 يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.