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