عند طرح إصدار جديد، يتم تحديد تاريخ لإيقاف الإصدار القديم نهائيًا، ولن يكون متاحًا بعد ذلك التاريخ. في ما يلي بعض الإرشادات الأخرى التي يجب وضعها في الاعتبار:
- نسعى جاهدين إلى إتاحة خمسة أرقام إصدار رئيسية كحد أقصى في أي وقت.
- تبلغ مدة صلاحية الإصدارات الرئيسية حوالي 12 شهرًا، أما الإصدارات الثانوية فتبلغ 10 أشهر.
- سيكون عليك إجراء ترقيتَين كحدّ أقصى في السنة، وليس عليك إجراء الترقية بترتيب تسلسلي صارم، فيمكنك مثلاً الترقية من الإصدار (N) مباشرةً إلى الإصدار (N+2).
تتوافق مكتبات العملاء مع أي إصدارات متاحة من الخدمة، ما يتيح لك الترقية تدريجيًا من خلال تحديد إصدارات مختلفة من الخدمات المستخدَمة.
جدول المواعيد
يسرد الجدول التالي تواريخ الإيقاف النهائي والإيقاف نهائيًا لكل إصدار متاح، وتواريخ الإصدار المتوقّعة للإصدارات المستقبلية. ننصحك بالترقية إلى أحدث إصدار في أقرب وقت ممكن بعد طرحه. يشير التاريخ المبدئي إلى أنّ إيقاف الخدمة نهائيًا قد يحدث في أي وقت خلال ذلك الشهر، وقد تتغيّر التواريخ. يمكنك الاشتراك في المدوّنة لتلقّي تذكيرات بشأن الإعلان عن موعد الإيقاف النهائي لإصدارات واجهة برمجة التطبيقات.
| إصدار واجهة برمجة التطبيقات | تاريخ الإصدار | تاريخ الإيقاف النهائي | دليل الترقية |
|---|---|---|---|
| نُسخ الإصدارات التي تم طرحها | |||
| 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 | 22 يوليو 2026 | أغسطس 2027 | الترقية من الإصدار 24.2 إلى الإصدار 25 |
| v25.1 | 19 أغسطس 2026 | أغسطس 2027 | الترقية من الإصدار 25 إلى الإصدار 25.1 |
| v25.2 | 23 سبتمبر 2026 | أغسطس 2027 | الترقية من الإصدار 25.1 إلى الإصدار 25.2 |
| v26 | 14 أكتوبر 2026 | نوفمبر 2027 | الترقية من الإصدار 25.2 إلى الإصدار 26 |
| الإصدارات القادمة | |||
| v26.1 | تشرين الأول (أكتوبر) 2026 | نوفمبر 2027 | |
| v26.2 | نوفمبر 2026 | نوفمبر 2027 | |
| الإصدار 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:
- افتح واجهات برمجة التطبيقات والخدمات في Google Cloud Console.
- انقر على Google Ads API في الجدول.
- في علامة التبويب الفرعية المقاييس، من المفترض أن تظهر طلباتك الأخيرة على كل رسم بياني. يمكنك الاطّلاع على الطرق التي أرسلت طلبات إليها في جدول الطرق. يتضمّن اسم الطريقة إصدارًا من Google Ads API وخدمة واسم طريقة، مثل
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - (اختياري) اختَر الفترة الزمنية التي تريد عرضها لطلباتك.
الاختلافات بين الإيقاف النهائي والإيقاف التدريجي
| العبارة | الإيقاف النهائي | الغروب |
|---|---|---|
| التعريف | الإصدار القديم هو إصدار ليس الأحدث. بعد طرح إصدار جديد، سيتم وضع علامة متوقّف نهائيًا على جميع الإصدارات السابقة. | لم يعُد بالإمكان استخدام الإصدار الذي تم إيقافه. وستتعذّر الطلبات المُرسَلة إلى هذا الإصدار في تاريخ إنهاء العمل به أو بعده. |
| الآثار | سيظل بإمكانك استخدام الإصدارات المتوقفة نهائيًا إلى أن يتم إيقافها نهائيًا،
ولكن تتم إزالة تمييز مراجع الإصدارات المتوقفة نهائيًا لإظهار
أنّها لم تعُد الإصدار الأخير.
ننصحك بالترقية إلى أحدث إصدار في أقرب وقت ممكن للاستفادة من الميزات الجديدة. |
عليك الترقية من الإصدارات التي تم إيقافها نهائيًا على الفور
لاستخدام Google Ads API.
ننصحك بشدة بالترقية إلى أحدث إصدار باستخدام دليل الترقية. |
| التوقيت | في المتوسط، نطرح إصدارًا جديدًا كل 3 إلى 4 أشهر، وبالتالي سيتم إيقاف الإصدار المحدّد بعد حوالي 3 إلى 4 أشهر. | نهدف إلى إيقاف الإصدار نهائيًا بعد عام واحد من إطلاقه. |
| واجهة برمجة التطبيقات | ستظل نقاط نهاية واجهة برمجة التطبيقات للإصدارات المتوقّفة نهائيًا تعمل كالمعتاد.
يمكنك الوصول إلى نقاط نهاية واجهة برمجة التطبيقات باستخدام مكتبات العملاء وREST. ومع ذلك، لا تتم إضافة ميزات جديدة إلى الإصدارات المتوقّفة نهائيًا. |
تتوقف نقاط نهاية واجهة برمجة التطبيقات للإصدارات التي تم إيقافها نهائيًا عن العمل بعد تواريخ الإيقاف النهائي. ستعرض Google Ads API رسالة خطأ إذا حاولت الوصول إلى نقاط نهاية الإصدارات التي تم إيقافها. |
| مكتبات العملاء | لأغراض توفير مكتبات عملاء مضغوطة، سنتوقّف عن تضمين إصدارات واجهة برمجة التطبيقات المتوقّفة نهائيًا في إصدار جديد من مكتبة العملاء بعد تاريخ الإيقاف النهائي. يساعدك ذلك في توفير المساحة عند دمج مكتبات البرامج في مشاريعك. | لم تعُد مكتبات البرامج المتوافقة مع واجهات برمجة التطبيقات التي تم إيقافها متوافقة مع أي إصدارات جديدة من مكتبات البرامج بعد تواريخ إيقافها. |
| الدعم | نوفّر دعمًا منتظمًا للإصدارات المتوقّفة نهائيًا. | يرجع ذلك إلى أنّ الإصدارات التي تم إنهاء العمل بها لا تكون متوافقة بعد تاريخ إنهاء العمل. |
إصدارات مكتبة البرامج المتوافقة
يوضّح الجدول مكتبات البرامج التي تعمل مع إصدارات واجهة برمجة التطبيقات.
إنّ الحد الأدنى لإصدار مكتبة البرامج المدرَج كافٍ للإصدار الرئيسي من Google Ads API (مثل الإصدار 26). للاطّلاع على إصدار مكتبة البرامج المطلوب للإصدارات الثانوية، يُرجى الرجوع إلى سجلّ التغيير المرتبط.
جافا
Google Ads API |
مكتبة برامج Java |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
#C
Google Ads API |
مكتبة برامج .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
مكتبة برامج PHP |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
مكتبة برامج Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
مكتبة برامج Ruby |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
مكتبة برامج Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
إيقاف الميزات نهائيًا وإجراء تغييرات عليها
مع أنّ هذه الصفحة تركّز على دورات الحياة على مستوى إصدار واجهة برمجة التطبيقات، يتم تتبُّع عمليات إيقاف الميزات الفردية نهائيًا (مثل إيقاف "الحملات الذكية" نهائيًا) والتغييرات في سير العمل غير المرتبطة بإصدار (مثل متطلبات ميزانية "حملات زيادة الطلب" الجديدة) بشكل منفصل.
للاطّلاع على دورات حياة الميزات القادمة والتغييرات السلوكية في جميع الإصدارات النشطة، راجِع دليل إيقاف الميزات نهائيًا والتغييرات غير المرتبطة بإصدار.