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