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

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

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

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

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

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

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

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

يمكنك الاطّلاع على قائمة بالطرق والخدمات التي طلبها مشروعك مؤخرًا باستخدام 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 أشهر تقريبًا.	ونحن نهدف إلى إيقاف أحد الإصدارات بعد عام واحد من إطلاقه.
API	نقاط نهاية واجهة برمجة التطبيقات للإصدارات المتوقّفة لا تزال تعمل على النحو المعتاد. يمكنك الوصول إلى نقاط نهاية واجهة برمجة التطبيقات باستخدام مكتبات العملاء وREST وما إلى ذلك، ولكن لا تتم إضافة ميزات جديدة إلى الإصدارات التي تم إيقافها نهائيًا.	تتوقّف نقاط نهاية واجهة برمجة التطبيقات للإصدارات التي تم إيقافها نهائيًا بعد تواريخ الإيقاف النهائي. ستعرض Google Ads API رسالة خطأ إذا حاولت الوصول إلى نقاط نهاية واجهة برمجة التطبيقات الخاصة بالإصدارات التي تم إيقافها نهائيًا.
مكتبات البرامج	لأغراض توفير مكتبات مدمجة للعملاء، سنتوقف عن تضمين الإصدارات المتوقّفة نهائيًا من واجهة برمجة التطبيقات في إصدار جديد من مكتبة العملاء بعد تاريخ الإيقاف النهائي. يساعدك ذلك في توفير المساحة عند دمج مكتبات العملاء في مشاريعك.	لم تعُد مكتبات العملاء تتيح استخدام إصدارات واجهة برمجة التطبيقات التي تم إيقافها نهائيًا في أي من إصدارات مكتبة البرامج الجديدة بعد تواريخ الإيقاف النهائي.
الدعم	نوفّر دعمًا منتظمًا للإصدارات التي تم إيقافها نهائيًا.	ولم تعُد الإصدارات التي تم إيقافها نهائيًا بعد تاريخ الإيقاف.

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

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

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

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

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

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