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