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