الإيقاف النهائي

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

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

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

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

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

إصدار واجهة برمجة التطبيقات	تاريخ الإصدار	تاريخ الإيقاف النهائي	دليل الترقية
الإصدارات التي تم طرحها
v21	‫6 أغسطس 2025	أغسطس 2026 (تاريخ مبدئي)	الترقية من الإصدار 20 إلى الإصدار 21
v22	‫15 أكتوبر 2025	أكتوبر 2026 (تاريخ مبدئي)	الترقية من الإصدار 21 إلى الإصدار 22
v23	‫28 يناير 2026	فبراير 2027	الترقية من الإصدار 22 إلى الإصدار 23
v23.1	‫25 فبراير 2026	فبراير 2027	الترقية من الإصدار 23 إلى الإصدار 23.1
v23.2	‫25 مارس 2026	فبراير 2027	الترقية من الإصدار 23.1 إلى الإصدار 23.2
v24	‫22 أبريل 2026	مايو 2027	الترقية من الإصدار 23.2 إلى الإصدار 24
v24.1	‫13 مايو 2026	مايو 2027	الترقية من الإصدار 24 إلى الإصدار 24.1
v24.2	‫24 يونيو 2026	يونيو 2027	الترقية من الإصدار 24.1 إلى الإصدار 24.2
الإصدارات القادمة
v25	يوليو 2026	أغسطس 2027
v25.1	أغسطس 2026	أغسطس 2027
v25.2	سبتمبر 2026	أغسطس 2027
v26	تشرين الأول (أكتوبر) 2026	نوفمبر 2027
الإصدار 26.1*	نوفمبر 2026	نوفمبر 2027

* تم تصنيف الإصدار 26.1 كإصدار اختياري بسبب تداخله مع موسم العطلات.

عرض الإصدارات التي يستخدمها مشروعك

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

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

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

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

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

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

إنّ الحدّ الأدنى لإصدار مكتبة البرامج المذكور يكفي لإصدار Google Ads API الرئيسي (مثل الإصدار 24). للاطّلاع على إصدار مكتبة البرامج المطلوب للإصدارات الثانوية، يُرجى الرجوع إلى سجلّ التغيير المرتبط.

إيقاف الميزات نهائيًا وإجراء تغييرات عليها

في حين تركّز هذه الصفحة على دورات الحياة على مستوى إصدار واجهة برمجة التطبيقات، يتم تتبُّع حالات إيقاف الميزات الفردية نهائيًا (مثل إيقاف "الحملات الذكية" نهائيًا) والتغييرات في سير العمل غير المرتبطة بإصدار (مثل متطلبات ميزانية "حملات زيادة الطلب" الجديدة) بشكل منفصل.

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