تحديد الإصدارات الدلالية
تتّبع 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) في مكانها. جميع طلبات البيانات من واجهة برمجة التطبيقات لإصدار رئيسي معيّن يتم توجيهها دائمًا إلى أحدث إصدار ثانوي مقابل، ولا تتيح Google Ads API طلب إصدارات ثانوية معيّنة.
ولن تحتاج إلى تغيير مسار الإصدار في عناوين URL لنقاط النهاية، وسيستمر الرمز الحالي في العمل بدون أي مشاكل. ولا يتم تتبُّع عمر أرقام الإصدارات الثانوية بشكل منفصل. بدلاً من ذلك، تشترك أرقام الإصدارات الثانوية في تاريخ الإيقاف النهائي نفسه مع رقم الإصدار الرئيسي المقابل لها.
تضيف أرقام الإصدارات الثانوية ميزات أو تحديثات لا تؤثر في الرمز الحالي. لاستخدام الحقول أو الميزات من رقم إصدار ثانوي مع مكتبة برامج، عليك ترقية مكتبة البرامج إلى إصدار يتضمّن تعريفات رقم الإصدار الثانوي.
الإيقاف النهائي والإيقاف التدريجي
تحتفظ Google Ads API بالعديد من أرقام الإصدارات الرئيسية النشطة في أي وقت. بشكل دوري، يتم إيقاف الإصدارات السابقة نهائيًا:
- متوقفة نهائيًا: يتم اعتبار الإصدار متوقفًا نهائيًا فقط إذا تم وضع علامة عليه صراحةً بأنّه متوقف نهائيًا. ستستمر طلبات البيانات من واجهة برمجة التطبيقات للإصدارات المتوقفة نهائيًا في العمل بنجاح حتى تاريخ إيقافها نهائيًا.
- الإيقاف النهائي: يتم إيقاف الإصدار في تاريخ إيقافه النهائي، وتتعذّر جميع طلبات البيانات من واجهة برمجة التطبيقات إلى نقطة النهاية الخاصة به.
ننشر الإشعارات على مدوّنة المطوّرين قبل إيقاف الإصدارات نهائيًا. يُرجى الاطّلاع على الجدول الزمني للإيقاف النهائي لمعرفة التواريخ النشطة والتواريخ التي تم إيقافها نهائيًا والتواريخ المجدولة للإيقاف النهائي.