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

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

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

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

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

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

إصدار واجهة برمجة التطبيقاتتاريخ الإصدارتاريخ الإيقاف النهائيتاريخ الإيقاف النهائيدليل الترقية
v1926 شباط (فبراير) 2025 الترقية من الإصدار 18 إلى الإصدار 19
v1816 أكتوبر 2024يونيو 2025سبتمبر 2025الترقية من الإصدار 17 إلى الإصدار 18
17.17 آب (أغسطس) 202416 أكتوبر 20244 حزيران (يونيو) 2025
v175 حزيران (يونيو) 202416 أكتوبر 20244 حزيران (يونيو) 2025

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

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

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

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

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

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

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

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

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

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

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

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

Java

مكتبة العميل للغة Java
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: 34.0.0

#C

مكتبة العميل لنظام ‎ .NET
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: 21.1.0

PHP

مكتبة العميل لـ PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

مكتبة البرامج لـ Python
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

مكتبة العميل للغة Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

مكتبة العميل لـ Perl
v18 Min: 25.0.1
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
تعديل على تقرير إحصاءات عبارات البحث في Google Ads API والنصوص البرمجية في "إعلانات Google" اعتبارًا من 3 آذار (مارس) 2025 اعتبارًا من 3 آذار (مارس) 2025، ستُظهر واجهة برمجة التطبيقات في "إعلانات Google" والنصوص البرمجية في "إعلانات Google" تقارير إحصاءات عبارات البحث أنّ جميع الفئات الفرعية للبحث فارغة. سبق أن أزالت واجهة مستخدم "إعلانات Google" هذا الحقل، وتعمل واجهة برمجة التطبيقات أيضًا على طرح هذا التغيير ليكون متّسقًا في "إعلانات Google". 3 آذار (مارس) 2025 اعتبارًا من 3 آذار (مارس) 2025، من المتوقّع أن تكون جميع قيم segments.search_subcategoryفارغة. إذا طلبت segments.search_subcategory في تقارير campaign_search_term_insight أو customer_search_term_insight، تأكَّد من أنّه يمكن لرمزك التعامل مع قيمة فارغة في segments.search_subcategory. السلسلة الفارغة هي سلسلة استقبال عام، لذا من المفترض أن يعالج الرمز البرمجي ذلك. ننصحك بإزالة segments.search_subcategory من طلب البحث.
التغييرات المرتقبة على حجم الصفحة في Google Ads API عند إيقاف الإصدار 16 نهائيًا، لن تتمكّن من ضبط الحقل page_size عند تقديم طلبات GoogleAdsService.Search فبراير 2025 عند إيقاف الإصدار 16 نهائيًا، ستتضمّن كل طلبات GoogleAdsService.Search حجمًا ثابتًا للصفحة يتألف من 10,000 صف.
تعديل على تاريخ انتهاء صلاحية اشتراك "مطابقة العملاء" اعتبارًا من 7 نيسان (أبريل) 2025، لن يسمح حقل UserList.membership_life_span بقيم أكبر من 540. 7 نيسان (أبريل) 2025 من 7 نيسان (أبريل) 2025 إلى 15 نيسان (أبريل) 2025، سنطرح تدريجيًا تغييرًا في الحقل UserList.membership_life_span. سيؤدي ضبط الحقل على قيمة أكبر من 540 إلى عرض خطأ RangeError.TOO_HIGH. سيتم نقل أي قائمة مستخدمين حالية تحتوي على قيمة حقل تزيد عن 540 تلقائيًا لتصبح مدة العضوية فيها 540 يومًا بحد أقصى. اطّلِع على تعديل في انتهاء صلاحية اشتراك "مطابقة العملاء" للحصول على مزيد من المعلومات.