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