أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
هناك إصدار رئيسي وإصدار ثانوي، بالتنسيق
vMAJOR_MINOR. على سبيل المثال، v0_0 هو
الإصدار الرئيسي الأول، وv0_1 هو الإصدار الثانوي الأول. تشير اللاحقة في
رقم الإصدار إلى نوع الإصدار: بالنسبة إلى الإصدارات الرئيسية، تكون اللاحقة دائمًا صفرًا،
وبالنسبة إلى الإصدارات الثانوية، تكون اللاحقة دائمًا أكبر من صفر.
الإصدارات الرئيسية
تُدخل الإصدارات الرئيسية تغييرات قد تؤدي إلى حدوث أعطال، أي تغييرات ليست
متوافقة مع الإصدارات القديمة.
ولكل إصدار رئيسي نقطة نهاية منفصلة، على سبيل المثال:
عند الترقية من إصدار رئيسي إلى آخر، قد تحتاج إلى تغيير
الرمز البرمجي قبل التبديل إلى نقطة نهاية الإصدار الرئيسي الجديد.
إذا كنت تستخدم مكتبة عملاء،
عليك الترقية إلى أحدث إصدار. توفّر الإصدارات الرئيسية الجديدة
دليل نقل البيانات لمساعدتك في حلّ أي تغييرات أساسية في الرمز البرمجي.
تشمل أمثلة التغييرات الأساسية ما يلي:
إزالة خدمة أو واجهة أو حقل أو طريقة أو قيمة مصنّف أو إعادة تسميتها
تغيير نوع حقل
تغيير تنسيق اسم المورد
تغيير تنسيق عنوان URL في تعريف HTTP
تغيير تنسيقات النتائج، مثل تغيير 0 إلى -- كقيمة تلقائية
تغيير سبب الخطأ الذي تم إرجاعه من "أ" إلى "ب"
الإصدارات الثانوية
لا تُجري الإصدارات الثانوية سوى تغييرات متوافقة مع الإصدارات القديمة.
عند إصدار إصدار ثانوي، يتم تلقائيًا تعديل نقطة النهاية التي يتم استخدامها حاليًا. ولن يؤدي ذلك إلى إيقاف الرمز البرمجي. يمكنك مواصلة
استخدام مكتبة العملاء الحالية.
تتضمّن الإصدارات الثانوية ميزات جديدة أو تعديلات لا تؤثّر في
الرمز الحالي. إذا أردت استخدام الميزات الجديدة، عليك ترقية
مكتبة العميل إلى أحدث
إصدار.
صور غروب الشمس
عندما يكون من المقرّر إيقاف إصدار قديم من Search Ads 360 Reporting API نهائيًا، سننشر
إشعارًا في مجموعة Google searchads-api-announcements.
تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Search Ads 360 Reporting API uses semantic versioning with major and minor versions, where major versions introduce breaking changes and minor versions are backwards-compatible."],["Major version releases require code changes and utilize separate endpoints, while minor version releases automatically update the existing endpoint without breaking existing code."],["Breaking changes in major versions might involve removing or renaming elements, changing types or formats, or modifying outputs and error reasons."],["Minor versions bring new features or updates but do not affect existing code; to utilize new features, upgrade your client library."],["Sunset notices for older API versions are posted on the searchads-api-announcements Google group."]]],[]]
