الإيقاف والإيقاف

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

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

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

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

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

إصدار واجهة برمجة التطبيقات تاريخ الإصدار تاريخ الإيقاف النهائي تاريخ الإيقاف النهائي دليل الترقية
v18 16 أكتوبر 2024 فبراير 2025 24 أيلول (سبتمبر) 2025
v17.1 7 آب (أغسطس) 2024 16 أكتوبر 2024 4 حزيران (يونيو) 2025 الترقية من الإصدار 17 إلى الإصدار 18
v17 5 حزيران (يونيو) 2024 16 أكتوبر 2024 4 حزيران (يونيو) 2025 الترقية من الإصدار 17 إلى الإصدار 18
v16.1 24 نيسان (أبريل) 2024 5 حزيران (يونيو) 2024 5 شباط (فبراير) 2025 الترقية من الإصدار 16 إلى الإصدار 17
v16 21 شباط (فبراير) 2024 5 حزيران (يونيو) 2024 5 شباط (فبراير) 2025 الترقية من الإصدار 16 إلى الإصدار 17

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

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

  1. افتح واجهات برمجة التطبيقات والخدمات في Google Cloud Console.
  2. انقر على Google Ads API في الجدول.
  3. في علامة التبويب الفرعية METRICS، من المفترض أن تظهر طلباتك الأخيرة في كل رسم بياني. يمكنك الاطّلاع على الطرق التي أرسلت طلبات إليها في جدول الطرق. يتضمّن اسم الإجراء إصدار واجهة برمجة التطبيقات مع "إعلانات Google" وخدمة واسم إجراء، مثل google.ads.googleads.v18.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: -

#C

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

PHP

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

Python

مكتبة البرامج لـ Python
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.0
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
التغييرات المرتقبة على حجم الصفحة في Google Ads API عند إيقاف الإصدار 16 نهائيًا، لن تتمكّن من ضبط الحقل page_size عند تقديم طلبات GoogleAdsService.Search. فبراير 2025 عند إيقاف الإصدار 16 نهائيًا، ستضمّ كل طلبات GoogleAdsService.Search حجمًا ثابتًا للصفحة يتألف من 10,000 صف.
استراتيجية عروض أسعار تكلفة النقرة المحسّنة لم تعُد Google Ads API تتيح ضبط تكلفة النقرة المحسّنة (ECPC) كاستراتيجية عروض أسعار في "الحملات على شبكة البحث" و"الحملات على الشبكة الإعلانية". أكتوبر 2024 ستؤدي طلبات ضبط الحقل enhanced_cpc_enabled على TRUE في استراتيجية عروض الأسعار إلى خطأ BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. ستستمرّ الحملات الحالية التي تستخدم استراتيجية عروض أسعار تكلفة النقرة المحسّنة في عرض إعلاناتها حتى 15 آذار (مارس) 2025. وبعد هذا التاريخ، سيتم نقلها تلقائيًا إلى استراتيجية "تكلفة النقرة اليدوية".