[null,null,["最后更新时间 (UTC)：2025-08-26。"],[[["\u003cp\u003eGoogle Ads API uses semantic versioning with major and minor versions, impacting how updates are handled.\u003c/p\u003e\n"],["\u003cp\u003eMajor version updates introduce breaking changes, requiring code modifications and endpoint URL changes to \u003ccode\u003ehttps://googleads.googleapis.com/vX\u003c/code\u003e, where 'X' represents the major version number.\u003c/p\u003e\n"],["\u003cp\u003eMinor version updates are backwards compatible, automatically applied to the existing endpoint, and primarily introduce new features.\u003c/p\u003e\n"],["\u003cp\u003eOlder API versions are periodically sunset; refer to the developer blog and deprecation schedule for announcements and timelines.\u003c/p\u003e\n"]]],[],null,["# Versioning\n\n| **Objective:** Learn how Google Ads API versioning works.\n\nSemantic versioning\n-------------------\n\nThe Google Ads API follows [semantic versioning](https://semver.org/) where there is a\na major and a minor version. The format of the version is `MAJOR.MINOR` or\n`vMAJOR_MINOR`. For example, `v21_0` is a major version, while\n`v21_1` is a minor version.\n\nSee the [release notes](/google-ads/api/docs/release-notes) for past versions.\n\n### Major versions\n\nMajor release versions introduce some breaking, backwards incompatible changes.\nThe version would end in zero with the format `vX_0` where `X` is the major\nversion number.\n\nEach major version has a separate endpoint. In this example URL, `X` is the\nmajor version number. \n\n https://googleads.googleapis.com/vX\n\nIf you are upgrading from an older major version, then your code may require\nchanges when you switch to the new major version endpoint. If you are using our\n[client libraries](/google-ads/api/docs/client-libs), then upgrade to the newest version.\nWhen there is a major version released, we will provide a migration guide that\nyou should go through to 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 from `0` to `--` as default value.\n- Changing the error reason returned from A to B.\n\n### Minor versions\n\nMinor versions only introduce backward-compatible changes. For a minor version,\n`vMAJOR_MINOR` would have a `MINOR` number greater than zero.\n\nWhen a minor version is released, the endpoint that is already in use will\nautomatically be updated. This won't cause your code to break. You can\ncontinue to use your existing client libraries.\n\nMinor versions include new features or updates that don't affect your\nexisting code. If you want to use these new features, then upgrade your\n[client libraries](/google-ads/api/docs/client-libs) to the newest version.\n\nSunsets\n-------\n\nPeriodically, older Google Ads API versions will need to sunset. We will post notices\non the [developer blog](//ads-developers.googleblog.com/search/label/google_ads_api)\nwhen a version is about to sunset. The\n[deprecation schedule](/google-ads/api/docs/sunset-dates) is updated with future sunset\ndates."]]
