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

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

• وتتوفر ثلاثة إصدارات رئيسية على الأكثر في آن واحد.
• تستغرق الإصدارات الرئيسية فترة عمرها 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	مايو/يونيو 2024	كانون الثاني (يناير) 2025
v16	21 فبراير 2024	مايو/يونيو 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. في علامة التبويب الفرعية METRICS، من المفترض أن تظهر لك طلباتك الأخيرة في شكل بياني. كل رسم بياني. يمكنك الاطّلاع على الطرق التي أرسلت إليها الطلبات في جدول الطرق. اسم الطريقة يتضمّن إصدارًا من Google Ads API وخدمة واسم طريقة، مثل google.ads.googleads.v17.services.GoogleAdsService.Mutate
4. (اختياري) اختَر الإطار الزمني الذي تريد عرضه لطلباتك.

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

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

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

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

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

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

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

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