مع إطلاق إصدار جديد، يتم تحديد تاريخ الإيقاف النهائي للإصدار المتوقّف عن العمل والذي لن يكون هذا الإصدار متاحًا بعده. في ما يلي بعض الإرشادات الأخرى التي يجب أخذها في الاعتبار:
- وتتوفر ثلاثة إصدارات رئيسية على الأكثر في آن واحد.
- تستغرق الإصدارات الرئيسية فترة تبلغ 12 شهرًا تقريبًا، للإصدارات الثانوية: 10 أشهر.
- سيكون عليك إجراء ترقيتين سنويًا كحدّ أقصى، وليس عليك الترقية بترتيب تسلسلي صارم، على سبيل المثال، يمكنك الترقية من الإصدار (N) مباشرةً إلى الإصدار (N+2).
- ويكون التداخل بين تاريخ إصدار جميع مكتبات البرامج لأحدث إصدار والإصدار المراد إيقافه هو 20 أسبوعًا على الأقل.
تتوافق مكتبات العملاء مع أي إصدارات متاحة من الخدمة، لذا يمكنك الترقية تدريجيًا من خلال تحديد إصدارات مختلفة من الخدمات المستخدمة.
جدول المواعيد
يسرد الجدول أدناه التواريخ المحددة للإيقاف والإيقاف لكل إصدار متاح، وتواريخ الإصدار المتوقعة للإصدارات المستقبلية. ونشجعك على الترقية إلى أحدث إصدار في أقرب وقت ممكن بعد إطلاقه.
إصدار واجهة برمجة التطبيقات | تاريخ الإصدار | تاريخ الإيقاف | تاريخ غروب الشمس | دليل الترقية |
---|---|---|---|---|
v18 | سبتمبر/أكتوبر 2024 | يناير/فبراير 2025 | أيلول (سبتمبر) 2025 | |
v17.1 | يوليو/أغسطس 2024 | سبتمبر/أكتوبر 2024 | مايو 2025 | |
v17 | مايو/يونيو 2024 | سبتمبر/أكتوبر 2024 | مايو 2025 | |
v16.1 | 24 أبريل 2024 | مايو/يونيو 2024 | كانون الثاني (يناير) 2025 | |
v16 | 21 فبراير 2024 | مايو/يونيو 2024 | كانون الثاني (يناير) 2025 | |
v15 | 18 تشرين الأول (أكتوبر) 2023 | 21 فبراير 2024 | 25 سبتمبر 2024 | الترقية من الإصدار 15 إلى الإصدار 16 |
v14.1 | 9 آب (أغسطس) 2023 | 18 تشرين الأول (أكتوبر) 2023 | 5 يونيو 2024 | |
v14 | 7 حزيران (يونيو) 2023 | 18 تشرين الأول (أكتوبر) 2023 | 5 يونيو 2024 | الترقية من الإصدار 14 إلى الإصدار 15 |
عرض النُسخ التي يستخدمها مشروعك
يمكنك الاطّلاع على قائمة بالطرق والخدمات التي طلبها مشروعك مؤخرًا باستخدام Google Cloud Console:
- افتح واجهات برمجة التطبيقات والخدمات في Google Cloud Console.
- انقر على Google Ads API في الجدول.
- في علامة التبويب الفرعية المقاييس، من المفترض أن تظهر لك طلباتك الأخيرة في رسم بياني. يمكنك معرفة الطرق التي أرسلت إليها الطلبات في
جدول الطرق. يتضمّن اسم الطريقة
إصدارًا من Google Ads API وخدمة واسم طريقة، مثل
google.ads.googleads.v17.services.GoogleAdsService.Mutate
. - (اختياري) اختَر الإطار الزمني الذي تريد عرضه لطلباتك.
الاختلافات بين الإيقاف النهائي والإيقاف النهائي
المصطلح | إيقاف | غروب الشمس الساحر |
---|---|---|
التعريف | الإصدار الذي تم إيقافه هو إصدار ليس أحدث. بعد طرح إصدار جديد، يتم وضع علامة متوقّفة نهائيًا على جميع الإصدارات السابقة. | لم يعُد من الممكن استخدام الإصدار الذي تم إيقافه نهائيًا. سيتعذّر إرسال الطلبات إلى هذه النسخة في تاريخ الإيقاف النهائي أو بعده. |
الآثار | سيظل بإمكانك استخدام الإصدارات المتوقّفة نهائيًا إلى أن يتم إيقافها،
ولكن يتم إلغاء تمييز الإشارات إلى الإصدارات المتوقّفة نهائيًا لتوضيح
أنّها لم تعُد الإصدارات الأحدث.
ننصحك بالترقية إلى أحدث إصدار في أقرب وقت ممكن للاستفادة من الميزات الجديدة. |
عليك الترقية من الإصدارات التي تم إيقافها نهائيًا على الفور لاستخدام Google Ads API.
ننصحك بشدة بالترقية إلى أحدث إصدار، باستخدام دليل الترقية. |
التوقيت | في المتوسّط، نطرح إصدارًا جديدًا كل 3 إلى 4 أشهر، لذا سيتم إيقاف هذا الإصدار نهائيًا بعد 3 إلى 4 أشهر تقريبًا. | ونحن نهدف إلى إيقاف أحد الإصدارات بعد عام واحد من إطلاقه. |
API | نقاط نهاية واجهة برمجة التطبيقات للإصدارات المتوقّفة لا تزال تعمل على النحو المعتاد.
يمكنك الوصول إلى نقاط نهاية واجهة برمجة التطبيقات باستخدام مكتبات العملاء وREST وما إلى ذلك، ولكن لا تتم إضافة ميزات جديدة إلى الإصدارات التي تم إيقافها نهائيًا. |
تتوقّف نقاط نهاية واجهة برمجة التطبيقات للإصدارات التي تم إيقافها نهائيًا بعد تواريخ الإيقاف النهائي. ستعرض Google Ads API رسالة خطأ إذا حاولت الوصول إلى نقاط نهاية واجهة برمجة التطبيقات الخاصة بالإصدارات التي تم إيقافها نهائيًا. |
مكتبات البرامج | لأغراض توفير مكتبات مدمجة للعملاء، سنتوقف عن تضمين الإصدارات المتوقّفة نهائيًا من واجهة برمجة التطبيقات في إصدار جديد من مكتبة العملاء بعد تاريخ الإيقاف النهائي. يساعدك ذلك في توفير المساحة عند دمج مكتبات العملاء في مشاريعك. | لم تعُد مكتبات العملاء تتيح استخدام إصدارات واجهة برمجة التطبيقات التي تم إيقافها نهائيًا في أي من إصدارات مكتبة البرامج الجديدة بعد تواريخ الإيقاف النهائي. |
الدعم | نوفّر دعمًا منتظمًا للإصدارات التي تم إيقافها نهائيًا. | ولم تعُد الإصدارات التي تم إيقافها نهائيًا بعد تاريخ الإيقاف. |
إصدارات مكتبة البرامج المتوافقة
يعرض الجدول مكتبات العملاء التي تعمل مع إصدارات واجهة برمجة التطبيقات.
Java
Google Ads API |
مكتبة البرامج لـ Java |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
مكتبة برامج لـ NET. |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
مكتبة البرامج للغة PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
مكتبة البرامج للغة Python |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
مكتبة عملاء Ruby |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
مكتبة البرامج لـ Perl |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: 21.0.0 |
إيقاف الميزات نهائيًا
راقِب مدوّنة مطوّري "إعلانات Google" بانتظام لتكون أول من يسمع عن الإيقاف النهائي للميزات القادمة.
يسرد الجدول أدناه عمليات الإيقاف النهائي للميزات المحددة المخطط لها حاليًا في Google Ads API. يمكن العثور على مزيد من التفاصيل حول كل عملية إيقاف في مشاركات المدونة المرتبطة.
الميزة | الوصف | تاريخ السريان | ملاحظات إضافية |
---|---|---|---|
استراتيجية عروض أسعار العمولات |
لم تعُد Google Ads API
تتيح إنشاء "حملات الفنادق" التي تستخدِم استراتيجية عروض أسعار COMMISSION
.
|
30 أبريل 2024 |
ستؤدي طلبات إنشاء "حملات فنادق جديدة" أو تطبيق استراتيجية عروض الأسعار COMMISSION
على الحملات الحالية إلى حدوث خطأ
BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . سيستمر عرض الحملات الحالية التي تستخدم استراتيجية عروض الأسعار "COMMISSION "
حتى 31 تشرين الأول (أكتوبر) 2024. وبعد هذا اليوم، سيتوقف عرض الحملات إلى أن يتم تعديل استراتيجية عروض الأسعار الخاصة بها.
|