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

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

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

تدعم مكتبات البرامج أي إصدارات متاحة من بحيث يمكنك الترقية تدريجيًا من خلال تحديد إصدارات مختلفة من

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

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

إصدار واجهة برمجة التطبيقات تاريخ الإصدار تاريخ الإيقاف تاريخ غروب الشمس دليل الترقية
v18 سبتمبر/أكتوبر 2024 يناير/فبراير 2025 أيلول (سبتمبر) 2025
v17.1 7 أغسطس 2024 سبتمبر/أكتوبر 2024 مايو 2025
v17 5 يونيو 2024 سبتمبر/أكتوبر 2024 مايو 2025
v16.1 24 أبريل 2024 5 يونيو 2024 كانون الثاني (يناير) 2025 الترقية من الإصدار 16 إلى الإصدار 17
v16 21 فبراير 2024 5 يونيو 2024 كانون الثاني (يناير) 2025 الترقية من الإصدار 16 إلى الإصدار 17
v15 18 تشرين الأول (أكتوبر) 2023 21 فبراير 2024 25 سبتمبر 2024 الترقية من الإصدار 15 إلى الإصدار 16

عرض النُسخ التي يستخدمها مشروعك

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

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

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

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

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

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

ننصحك بشدة بالترقية إلى أحدث إصدار باستخدام دليل الترقية.

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

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

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

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

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

Java

مكتبة البرامج لـ Java
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: 32.0.0

#C

مكتبة برامج لـ NET.
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: 20.1.0

PHP

مكتبة البرامج للغة PHP
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: 23.1.0

Python

مكتبة البرامج للغة Python
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -
v15 Min: 22.1.0
Max: -

Ruby

مكتبة عملاء Ruby
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -

Perl

مكتبة البرامج لـ Perl
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -

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

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

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

الميزة الوصف تاريخ السريان ملاحظات إضافية
استراتيجية عروض أسعار العمولات واجهة برمجة تطبيقات "إعلانات Google" لم تعُد توفّر ميزة إنشاء "حملات الفنادق" التي تتضمّن COMMISSION. استراتيجية عروض الأسعار 30 أبريل 2024 طلبات إنشاء حملات فنادق جديدة أو تطبيق COMMISSION استراتيجية عروض الأسعار للحملات الحالية إلى BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED خطأ. الحملات الحالية التي تستخدم عروض أسعار "COMMISSION" سارية حتى 31 أكتوبر 2024. بعد هذا اليوم سيتوقف عرض الحملات إلى أن يتم تحديث استراتيجية عروض الأسعار الخاصة بها.