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