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