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

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

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

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

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

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

إصدار واجهة برمجة التطبيقات	تاريخ الإصدار	تاريخ الإيقاف	تاريخ غروب الشمس	دليل الترقية
v18	16 أكتوبر 2024	فبراير 2025	24 أيلول (سبتمبر) 2025
الإصدار 17.1	7 آب (أغسطس) 2024	أيلول (سبتمبر)/تشرين الأول (أكتوبر) 2024	4 حزيران (يونيو) 2025	الترقية من الإصدار 17 إلى الإصدار 18
v17	5 يونيو 2024	أيلول (سبتمبر)/تشرين الأول (أكتوبر) 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 خطأ إذا حاولت الوصول إلى نقاط نهاية واجهة برمجة التطبيقات للإصدارات التي سيتم إيقافها نهائيًا.
مكتبات البرامج	لأغراض توفير مكتبات مدمجة للعملاء، سنتوقف عن تضمين الإصدارات المتوقّفة نهائيًا من واجهة برمجة التطبيقات في إصدار جديد من مكتبة العملاء بعد تاريخ الإيقاف النهائي. يساعدك ذلك في توفير المساحة عند دمج مكتبات العملاء في مشاريعك.	لم تعُد مكتبات العملاء تتيح استخدام إصدارات واجهة برمجة التطبيقات التي تم إيقافها نهائيًا في أي من إصدارات مكتبة البرامج الجديدة بعد تواريخ الإيقاف النهائي.
الدعم	نوفّر دعمًا منتظمًا للإصدارات المتوقّفة نهائيًا.	لن تعود الإصدارات التي تم إيقافها نهائيًا متوافقة بعد تاريخ الإيقاف نهائيًا .

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

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

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

راقِب بانتظام مدونة مطوّري "إعلانات 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. وبعد هذا التاريخ، سيتم نقلها تلقائيًا إلى استراتيجية "تكلفة النقرة اليدوية".