주 출시 버전에는 이전 버전과 호환되지 않는 브레이킹 체인지가 도입됩니다.
버전은 vX_0 형식으로 0으로 끝나며 여기서 X은 메이저 버전 번호입니다.
각 주요 버전에는 별도의 엔드포인트가 있습니다. 이 예시 URL에서 X은 주요 버전 번호입니다.
https://googleads.googleapis.com/vX
이전 주 버전에서 업그레이드하는 경우 새 주 버전 엔드포인트로 전환할 때 코드 변경이 필요할 수 있습니다. Google의 클라이언트 라이브러리를 사용하는 경우 최신 버전으로 업그레이드하세요.
주요 버전이 출시되면 코드의 호환성이 깨지는 변경사항을 수정하기 위해 따라야 하는 마이그레이션 가이드가 제공됩니다.
이전 버전과 호환되지 않는 변경사항의 예는 다음과 같습니다.
서비스, 인터페이스, 필드, 메서드 또는 열거형 값의 삭제 또는 이름 변경
필드 유형 변경
리소스 이름 형식 변경
HTTP 정의에서 URL 형식 변경
0에서 --로 기본값을 변경하는 등 출력 형식을 변경합니다.
A에서 B로 반환되는 오류 이유 변경
부 버전
부 버전은 이전 버전과 호환되는 변경사항만 도입합니다. 부 버전의 경우 vMAJOR_MINOR의 MINOR 번호가 0보다 큽니다.
부 버전이 출시되면 이미 사용 중인 엔드포인트가 자동으로 업데이트됩니다. 이로 인해 코드가 중단되지는 않습니다. 기존 클라이언트 라이브러리를 계속 사용할 수 있습니다.
부 버전에는 기존 코드에 영향을 미치지 않는 새로운 기능이나 업데이트가 포함됩니다. 이러한 새로운 기능을 사용하려면 클라이언트 라이브러리를 최신 버전으로 업그레이드하세요.
일몰
이전 Google Ads API 버전은 주기적으로 지원이 종료됩니다. 버전 지원이 종료되면 개발자 블로그에 공지가 게시됩니다. 지원 중단 일정이 향후 지원 중단 날짜로 업데이트됩니다.
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[[["\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."]]
