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