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