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

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

• تتوفّر ثلاثة إصدارات رئيسية كحدّ أقصى في الوقت نفسه.
• تبلغ مدة الإصدارات الرئيسية حوالي 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.v16.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. وبعد هذا اليوم، سيتوقّف عرض إعلانات الحملات إلى أن يتم تعديل استراتيجية عروض الأسعار الخاصة بها.