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