تحديد الإصدار

الترقيم الدلالي للإصدارات

تتّبع Google Ads API الترقيم الدلالي للإصدارات، حيث يتوفّر إصدار رئيسي وإصدار ثانوي. يكون تنسيق الإصدار MAJOR.MINOR أو vMAJOR_MINOR. على سبيل المثال، v20_0 هو إصدار رئيسي، بينما v20_1 هو إصدار ثانوي.

يمكنك الاطّلاع على ملاحظات الإصدار للنُسخ السابقة.

الإصدارات الرئيسية

تتضمّن إصدارات الإصدارات الرئيسية بعض التغييرات التي لا تتوافق مع الإصدارات السابقة. سينتهي رقم الإصدار بصفر بالتنسيق vX_0 حيث X هو رقم الإصدار الرئيسي.

يحتوي كل إصدار رئيسي على نقطة نهاية منفصلة. في مثال عنوان URL هذا، X هو رقم الإصدار الرئيسي.

https://googleads.googleapis.com/vX

إذا كنت بصدد الترقية من إصدار رئيسي قديم، قد يتطلّب الرمز إجراء تغييرات عند التبديل إلى نقطة نهاية الإصدار الرئيسي الجديد. إذا كنت تستخدم مكتبات برامجنا، عليك الترقية إلى أحدث إصدار. عند إصدار نسخة رئيسية، سنقدّم دليل نقل بيانات يجب الاطّلاع عليه لإصلاح أي تغييرات غير متوافقة في الرمز.

تشمل الأمثلة على التغييرات غير المتوافقة ما يلي:

  • إزالة أو إعادة تسمية خدمة أو واجهة أو حقل أو طريقة أو قيمة تعداد
  • تغيير نوع حقل
  • تغيير تنسيق اسم مورد
  • تغيير تنسيق عنوان URL في تعريف HTTP
  • تغيير تنسيقات الإخراج، مثل التغيير من 0 إلى -- كقيمة تلقائية
  • تغيير سبب الخطأ الذي تم عرضه من A إلى B

الإصدارات الثانوية

لا تتضمّن الإصدارات الثانوية سوى تغييرات متوافقة مع الأنظمة القديمة. بالنسبة إلى إصدار ثانوي، سيكون vMAJOR_MINOR رقمًا أكبر من صفر.MINOR

عند إصدار نسخة ثانوية، سيتم تلقائيًا تعديل نقطة النهاية المستخدَمة حاليًا. لن يؤدي ذلك إلى تعطُّل الرمز. يمكنك مواصلة استخدام مكتبات البرامج الحالية.

تتضمّن الإصدارات الثانوية ميزات جديدة أو تحديثات لا تؤثّر في الرمز الحالي. إذا أردت استخدام هذه الميزات الجديدة، عليك ترقية مكتبات البرامج إلى أحدث إصدار.

صور غروب الشمس

سنوقف نهائيًا بشكلٍ دوري إصدارات Google Ads API القديمة. سننشر إشعارات على مدوّنة المطوّرين عندما يوشك أحد الإصدارات على إيقافه نهائيًا. يتم تعديل جدول الإيقاف النهائي ليشمل تواريخ الإيقاف النهائي المستقبلية.