أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تحديد الإصدارات في Search Ads 360 Reporting API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تستخدِم Search Ads 360 Reporting API التسمية الدلالية.
هناك إصدار رئيسي وإصدار ثانوي، بالتنسيق
vMAJOR_MINOR. على سبيل المثال، v0_0 هو
الإصدار الرئيسي الأول، وv0_1 هو الإصدار الثانوي الأول. تشير اللاحقة في
رقم الإصدار إلى نوع الإصدار: بالنسبة إلى الإصدارات الرئيسية، تكون اللاحقة دائمًا صفرًا،
وبالنسبة إلى الإصدارات الثانوية، تكون اللاحقة دائمًا أكبر من صفر.
الإصدارات الرئيسية
تُدخل الإصدارات الرئيسية تغييرات قد تؤدي إلى حدوث أعطال، أي تغييرات ليست
متوافقة مع الإصدارات القديمة.
ولكل إصدار رئيسي نقطة نهاية منفصلة، على سبيل المثال:
https://searchads360.googleapis.com/v0
https://searchads360.googleapis.com/v1
عند الترقية من إصدار رئيسي إلى آخر، قد تحتاج إلى تغيير
الرمز البرمجي قبل التبديل إلى نقطة نهاية الإصدار الرئيسي الجديد.
إذا كنت تستخدم مكتبة برامج،
يجب الترقية إلى أحدث إصدار. توفّر الإصدارات الرئيسية الجديدة ملفًا توجيهيًا لعمليات نقل البيانات بهدف مساعدتك في حلّ أي تغييرات جذرية في الرمز البرمجي.
تشمل أمثلة التغييرات الأساسية ما يلي:
- إزالة أو إعادة تسمية خدمة أو واجهة أو حقل أو طريقة أو قيمة تعداد
- تغيير نوع حقل
- تغيير تنسيق اسم المورد
- تغيير تنسيق عنوان URL في تعريف HTTP
- تغيير تنسيقات الإخراج، مثل تغيير
0 إلى -- كقيمة تلقائية
- تغيير سبب الخطأ الذي تم إرجاعه من "أ" إلى "ب"
الإصدارات الثانوية
لا تُجري الإصدارات الثانوية سوى تغييرات متوافقة مع الإصدارات القديمة.
عند إصدار إصدار ثانوي، يتم تلقائيًا تعديل نقطة النهاية التي يتم استخدامها حاليًا. ولن يؤدي ذلك إلى إيقاف عمل الرمز البرمجي. يمكنك مواصلة
استخدام مكتبة العملاء الحالية.
تتضمّن الإصدارات الثانوية ميزات جديدة أو تعديلات لا تؤثّر في
الرمز الحالي. إذا أردت استخدام الميزات الجديدة، عليك ترقية
مكتبة العملاء إلى أحدث
إصدار.
صور غروب الشمس
عندما يتم إيقاف إصدار قديم من Search Ads 360 Reporting API نهائيًا، ننشر إشعارًا على مجموعة Google للإعلانات على واجهة برمجة التطبيقات في Searchads.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe 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.\u003c/p\u003e\n"],["\u003cp\u003eMajor version releases require code changes and utilize separate endpoints, while minor version releases automatically update the existing endpoint without breaking existing code.\u003c/p\u003e\n"],["\u003cp\u003eBreaking changes in major versions might involve removing or renaming elements, changing types or formats, or modifying outputs and error reasons.\u003c/p\u003e\n"],["\u003cp\u003eMinor versions bring new features or updates but do not affect existing code; to utilize new features, upgrade your client library.\u003c/p\u003e\n"],["\u003cp\u003eSunset notices for older API versions are posted on the searchads-api-announcements Google group.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API uses semantic versioning with major (e.g., v0) and minor (e.g., v0_1) versions. Major versions have breaking changes, require code modifications, a new endpoint, and client library upgrades. Minor versions are backward-compatible, automatically update the existing endpoint, and only require client library upgrades for new features. Breaking changes may involve removing or renaming elements, changing field types or output formats. Sunsets are posted on the Google group.\n"],null,["# Versioning in the Search Ads 360 Reporting API\n\nThe Search Ads 360 Reporting API uses [semantic versioning](https://semver.org/).\n\nThere are major and minor versions, formatted as\n`v`\u003cvar translate=\"no\"\u003eMAJOR\u003c/var\u003e`_`\u003cvar translate=\"no\"\u003eMINOR\u003c/var\u003e. For example, `v0_0` is the\nfirst major version, and `v0_1` the first minor version. The suffix of the\nversion number indicates the version type: for major versions it is always zero,\nand for minor versions it is always greater than zero.\n\nMajor versions\n--------------\n\nMajor releases introduce breaking changes, that is, changes that are not\nbackwards compatible.\n\nEach major version has a separate endpoint, for example: \n\n```text\nhttps://searchads360.googleapis.com/v0\n\nhttps://searchads360.googleapis.com/v1\n```\n\nWhen upgrading from one major version to another, you may need to change your\ncode before switching to the new major version endpoint.\n\nIf you use a [client library](/search-ads/reporting/client-libraries/client-libraries),\nyou need to upgrade to the newest version. New major versions provide a\nmigration guide to help you fix any breaking changes in your code.\n\nExamples of breaking changes include:\n\n- Removing or renaming a service, interface, field, method or enum value.\n- Changing the type of a field.\n- Changing a resource name format.\n- Changing the URL format in the HTTP definition.\n- Changing output formats, such as, changing `0` to `--` as the default value.\n- Changing the error reason returned from A to B.\n\nMinor versions\n--------------\n\nMinor versions introduce only backwards-compatible changes.\n\nWhen a minor version is released, the endpoint that is already in use is\nautomatically updated. This does not cause your code to break. You can continue\nto use your existing client library.\n\nMinor versions include new features or updates that do not affect your existing\ncode. If you want to use the new features, you need to upgrade your\n[client library](/search-ads/reporting/client-libraries/client-libraries) to the latest\nversion.\n\nSunsets\n-------\n\nWhen an older Search Ads 360 Reporting API version is scheduled to sunset, we\npost a notice on the [searchads-api-announcements](https://groups.google.com/g/searchads-api-announcements) Google group."]]
