API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google
searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
نسخه‌سازی در Search Ads 360 Reporting API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Search Ads 360 Reporting API از نسخه‌سازی معنایی استفاده می‌کند.
نسخه های اصلی و فرعی وجود دارد که به صورت v MAJOR _ MINOR فرمت شده اند. به عنوان مثال، v0_0 اولین نسخه اصلی و v0_1 اولین نسخه کوچک است. پسوند شماره نسخه نشان دهنده نوع نسخه است: برای نسخه های اصلی همیشه صفر است و برای نسخه های کوچک همیشه بزرگتر از صفر است.
نسخه های اصلی
نسخه های اصلی تغییرات شکسته ای را ایجاد می کنند، یعنی تغییراتی که با عقب سازگار نیستند.
هر نسخه اصلی یک نقطه پایان جداگانه دارد، به عنوان مثال:
https://searchads360.googleapis.com/v0
https://searchads360.googleapis.com/v1
هنگام ارتقاء از یک نسخه اصلی به نسخه دیگر، ممکن است لازم باشد قبل از تغییر به نقطه پایانی نسخه اصلی جدید، کد خود را تغییر دهید.
اگر از کتابخانه مشتری استفاده می کنید، باید به جدیدترین نسخه ارتقا دهید. نسخه‌های اصلی جدید یک راهنمای انتقال ارائه می‌کنند تا به شما در رفع هرگونه تغییر شکسته در کدتان کمک کند.
نمونه هایی از تغییرات شکسته عبارتند از:
- حذف یا تغییر نام یک سرویس، رابط، فیلد، روش یا مقدار enum.
- تغییر نوع فیلد
- تغییر قالب نام منبع
- تغییر فرمت URL در تعریف HTTP.
- تغییر فرمت های خروجی، مانند تغییر
0 به -- به عنوان مقدار پیش فرض. - تغییر دلیل خطا از A به B برگردانده شد.
نسخه های کوچک
نسخه های کوچک فقط تغییرات سازگار با عقب را ارائه می دهند.
هنگامی که یک نسخه کوچک منتشر می شود، نقطه پایانی که از قبل در حال استفاده است به طور خودکار به روز می شود. این باعث نمی شود کد شما خراب شود. می توانید به استفاده از کتابخانه مشتری موجود خود ادامه دهید.
نسخه‌های کوچک شامل ویژگی‌ها یا به‌روزرسانی‌های جدیدی هستند که بر کد موجود شما تأثیری نمی‌گذارند. اگر می‌خواهید از ویژگی‌های جدید استفاده کنید، باید کتابخانه مشتری خود را به آخرین نسخه ارتقا دهید.
غروب
هنگامی که یک نسخه قدیمی‌تر Search Ads 360 Reporting API برای غروب برنامه‌ریزی شده است، ما اعلامیه‌ای را در گروه searchads-api-announcements Google پست می‌کنیم.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
