تحديد أرقام الإصدارات الدلالية
يتّبع Google Ads API نظام تحديد أرقام الإصدارات الدلالية، حيث يكون هناك إصدار رئيسي ورقم إصدار ثانوي. تكون صيغة الإصدار MAJOR.MINOR أو vMAJOR_MINOR. على سبيل المثال، v25_0 هو رقم الإصدار الرئيسي، بينما v25_1 هو رقم الإصدار الثانوي.
يمكنك الاطّلاع على ملاحظات الإصدارات السابقة.
الإصدارات الرئيسية
تتضمّن الإصدارات الرئيسية بعض التغييرات التي لا تتوافق مع الأنظمة القديمة.
ينتهي رقم الإصدار بالصفر، وتكون صيغته vX_0 حيث X هو رقم الإصدار الرئيسي.
لكل رقم إصدار رئيسي نقطة نهاية منفصلة. في عنوان URL هذا، X هو رقم الإصدار الرئيسي.
https://googleads.googleapis.com/vX
إذا كنت بصدد الترقية من رقم إصدار رئيسي أقدم، فقد يتطلّب الرمز إجراء تغييرات عند التبديل إلى نقطة النهاية الجديدة لرقم الإصدار الرئيسي. إذا كنت تستخدِم مكتبات العملاء، عليك الترقية إلى أحدث إصدار. عند إطلاق رقم إصدار رئيسي، سنقدّم دليل نقل بيانات يجب الاطّلاع عليه لإصلاح أي تغييرات قد تؤدي إلى عطل في الرمز.
تشمل أمثلة التغييرات غير المتوافقة مع الأنظمة القديمة ما يلي:
- إزالة خدمة أو واجهة أو حقل أو طريقة أو قيمة تعداد أو تغيير اسمها
- تغيير نوع حقل
- تغيير صيغة اسم مورد
- تغيير صيغة عنوان URL في تعريف HTTP
- تغيير صيغ الإخراج، مثل تغيير القيمة التلقائية من
0إلى-- - تغيير سبب الخطأ الذي يتم عرضه من A إلى B
الإصدارات الثانوية
لا تتضمّن الإصدارات الثانوية سوى تغييرات متوافقة مع الأنظمة القديمة. بالنسبة إلى الإصدار الثانوي، سيكون رقم MINOR في
vMAJOR_MINOR أكبر من صفر.
عند إطلاق رقم إصدار ثانوي، سيتم تعديل نقطة النهاية المستخدَمة حاليًا تلقائيًا. ولن يؤدي ذلك إلى حدوث مشاكل في الرمز. يمكنك مواصلة استخدام مكتبات العملاء الحالية.
تتضمّن الإصدارات الثانوية ميزات أو تعديلات جديدة لا تؤثر في الرمز الحالي. إذا أردت استخدام هذه الميزات الجديدة، عليك ترقية مكتبات العملاء إلى أحدث إصدار.
صور غروب الشمس
من حين لآخر، يجب إيقاف الإصدارات القديمة من Google Ads API. سننشر إشعارات على مدونة المطوّرين عندما يكون أحد الإصدارات على وشك الإيقاف. يتم تعديل جدول الإيقاف ليتضمّن تواريخ الإيقاف المستقبلية.