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