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

تحديد الدلالة الدلالية

تتّبع Google Ads API إصدارًا دلاليًا يكون فيه الإصدار الرئيسي والثانوي. تنسيق النسخة هو MAJOR.MINOR أو vMAJOR_MINOR. على سبيل المثال، v14_0 هو إصدار رئيسي، بينما v14_1 هو إصدار ثانوي.

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

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

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

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

https://googleads.googleapis.com/vX

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

تشمل الأمثلة على التغييرات التي قد تؤدي إلى أعطال ما يلي:

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

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

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

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

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

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

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