تستخدم Search Ads 360 Reporting API تحديد الإصدارات الدلالية.
توجد إصدارات رئيسية وثانوية بتنسيق
vMAJOR_MINOR على سبيل المثال، v0_0 هو العنصر
والإصدار الرئيسي الأول وv0_1 رقم الإصدار الثانوي الأول. لاحقة
يشير رقم الإصدار إلى نوع الإصدار: بالنسبة للإصدارات الرئيسية يكون دائمًا صفرًا،
وبالنسبة إلى الإصدارات الثانوية، تكون دائمًا أكبر من صفر.
الإصدارات الرئيسية
تقدم الإصدارات الرئيسية تغييرات قد تؤدي إلى أعطال، أي تغييرات لم يتم إجراؤها متوافقة مع الأنظمة القديمة.
لكل إصدار رئيسي نقطة نهاية منفصلة، على سبيل المثال:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
عند الترقية من إصدار رئيسي إلى آخر، قد تحتاج إلى تغيير الرمز قبل التبديل إلى نقطة نهاية الإصدار الرئيسي الجديد.
إذا كنت تستخدم مكتبة برامج، تحتاج إلى الترقية إلى أحدث إصدار. توفر الإصدارات الرئيسية الجديدة دليل نقل البيانات لمساعدتك في إصلاح أي تغييرات قد تؤدي إلى أعطال في الرمز البرمجي.
تشمل أمثلة التغييرات التي قد تؤدي إلى عطل ما يلي:
- إزالة أو إعادة تسمية خدمة أو واجهة أو حقل أو طريقة أو قيمة تعداد
- تغيير نوع الحقل.
- تغيير تنسيق اسم المورد.
- تغيير تنسيق عنوان URL في تعريف HTTP
- تغيير تنسيقات الإخراج، مثل تغيير
0إلى--كقيمة تلقائية - تغيير سبب الخطأ من "أ" إلى "ب".
الإصدارات الثانوية
تقدم الإصدارات الثانوية تغييرات متوافقة مع الإصدارات القديمة فقط.
عند إصدار إصدار ثانوي، تكون نقطة النهاية قيد الاستخدام يتم تحديثه تلقائيًا. لا يؤدي ذلك إلى تعطُّل الرمز. يمكنك المتابعة لاستخدام مكتبة البرامج الحالية.
تشتمل الإصدارات الثانوية على ميزات أو تحديثات جديدة لا تؤثر على الإصدار الحالي الرمز. إذا كنت تريد استخدام الميزات الجديدة، فعليك ترقية مكتبة العملاء إلى الأحدث .
صور غروب الشمس
عندما يتم إيقاف إصدار قديم من Search Ads 360 Reporting API نهائيًا، سننفّذ الإجراءات التالية: نشر إشعار على مجموعة Google searchads-api-announcements.