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