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

تحتفظ Google Ads API بعدة أرقام إصدارات رئيسية نشطة في أي وقت، ولا يُعتبر الإصدار متوقفًا نهائيًا إلا إذا تم وضع علامة عليه صراحةً بأنّه متوقف نهائيًا. وننشر تواريخ الإصدار والإيقاف النهائي مسبقًا لمساعدتك في التخطيط للترقيات. وبعد تاريخ إيقاف الإصدار، لن يكون متاحًا. في ما يلي بعض الإرشادات الأساسية المتعلّقة بالإصدارات التي يجب وضعها في الاعتبار:

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

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

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

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

إصدار واجهة برمجة التطبيقات	تاريخ الإصدار	تاريخ الإيقاف النهائي	التغييرات التي قد تؤدي إلى أعطال والترقية	الميزات والتحديثات	جدول الاختلافات في Proto
نُسخ الإصدارات التي تم طرحها
v23	‫28 يناير 2026	فبراير 2027	التغييرات التي قد تؤدي إلى عطل في الإصدار 23 (دليل الترقية)	ميزات الإصدار 23 وتحديثاته	v22 versus v23 proto diffs
v23.1	‫25 فبراير 2026	فبراير 2027	بلا (إصدار ثانوي)	الميزات والتحديثات في الإصدار 23.1	v22 versus v23 proto diffs
v23.2	‫25 مارس 2026	فبراير 2027	بلا (إصدار ثانوي)	ميزات الإصدار 23.2 وتحديثاته	v22 versus v23 proto diffs
v23.3	‫24 يونيو 2026	فبراير 2027	بلا (إصدار ثانوي)	ميزات الإصدار 23.3 وتحديثاته	v22 versus v23 proto diffs
v24	‫22 أبريل 2026	أيار (مايو) 2027	التغييرات التي قد تؤدي إلى عطل في الإصدار 24 (دليل الترقية)	ميزات الإصدار 24 وتحديثاته	الاختلافات بين الإصدار 23 والإصدار 24 من واجهة برمجة التطبيقات
v24.1	‫13 مايو 2026	أيار (مايو) 2027	بلا (إصدار ثانوي)	ميزات الإصدار 24.1 وتحديثاته	الاختلافات بين الإصدار 23 والإصدار 24 من واجهة برمجة التطبيقات
v24.2	‫24 يونيو 2026	حزيران (يونيو) 2027	بلا (إصدار ثانوي)	الميزات والتعديلات في الإصدار 24.2	الاختلافات بين الإصدار 23 والإصدار 24 من proto
v25	‫22 يوليو 2026	أغسطس 2027	التغييرات التي قد تؤدي إلى عطل في الإصدار 25 (دليل الترقية)	ميزات الإصدار 25 وتحديثاته	الاختلافات بين الإصدار 24 والإصدار 25 من واجهة برمجة التطبيقات
v25.1	‫19 أغسطس 2026	أغسطس 2027	بلا (إصدار ثانوي)	الميزات والتحديثات في الإصدار 25.1	الاختلافات بين الإصدار 24 والإصدار 25 من واجهة برمجة التطبيقات
v25.2	‫23 سبتمبر 2026	أغسطس 2027	بلا (إصدار ثانوي)	ميزات الإصدار 25.2 وتحديثاته	الاختلافات بين الإصدار 24 والإصدار 25 من واجهة برمجة التطبيقات
v26 (الأحدث)	‫14 أكتوبر 2026	نوفمبر 2027	التغييرات التي قد تؤدي إلى عطل في الإصدار 26 (دليل الترقية)	ميزات الإصدار 26 وتحديثاته	الاختلافات بين الإصدار 25 والإصدار 26 من واجهة برمجة التطبيقات
v26.1	‫28 أكتوبر 2026	نوفمبر 2027	بلا (إصدار ثانوي)	الميزات والتحديثات في الإصدار 26.1	الاختلافات بين الإصدار 25 والإصدار 26 من واجهة برمجة التطبيقات
v26.2	‫11 نوفمبر 2026	نوفمبر 2027	بلا (إصدار ثانوي)	الميزات والتعديلات في الإصدار 26.2	الاختلافات بين الإصدار 25 والإصدار 26 من واجهة برمجة التطبيقات
الإصدارات القادمة
الإصدار 26.3*	ديسمبر 2026	نوفمبر 2027
v27	يناير 2027	شباط (فبراير) 2028
v27.1	فبراير 2027	شباط (فبراير) 2028
v27.2	فبراير 2027	شباط (فبراير) 2028
v27.3	مارس 2027	شباط (فبراير) 2028
v27.4	مارس 2027	شباط (فبراير) 2028
v28	أبريل 2027	أيار (مايو) 2028
v28.1	أبريل 2027	أيار (مايو) 2028
v28.2	أيار (مايو) 2027	أيار (مايو) 2028
v28.3	أيار (مايو) 2027	أيار (مايو) 2028
v28.4	حزيران (يونيو) 2027	أيار (مايو) 2028
v28.5	حزيران (يونيو) 2027	أيار (مايو) 2028
v29	تموز (يوليو) 2027	أغسطس 2028
v29.1	تموز (يوليو) 2027	أغسطس 2028
v29.2	أغسطس 2027	أغسطس 2028
v29.3	أغسطس 2027	أغسطس 2028
v29.4	سبتمبر 2027	أغسطس 2028
v29.5	سبتمبر 2027	أغسطس 2028
v30	تشرين الأول (أكتوبر) 2027	نوفمبر 2028
v30.1	تشرين الأول (أكتوبر) 2027	نوفمبر 2028
v30.2	نوفمبر 2027	نوفمبر 2028
الإصدار 30.3*	ديسمبر 2027	نوفمبر 2028

* يُعدّ الإصداران 26.3 و30.3 اختياريَين بسبب تداخلهما مع موسم الأعياد.

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

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

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

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

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

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

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

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

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

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

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