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