تستخدِم 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.