Search Ads 360 Reporting API의 버전 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Search Ads 360 Reporting API는 시맨틱 버전 관리를 사용합니다.
vMAJOR_MINOR 형식의 메이저 버전과 마이너 버전이 있습니다. 예를 들어 v0_0은 첫 번째 메인 버전이고 v0_1은 첫 번째 마이너 버전입니다. 버전 번호의 접미사는 버전 유형을 나타냅니다. 주 버전의 경우 항상 0이고 부 버전의 경우 항상 0보다 큽니다.
주요 버전
주요 출시에는 이전 버전과 호환되지 않는 브레이킹 체인지, 즉 변경사항이 도입됩니다.
주 버전마다 별도의 엔드포인트가 있습니다. 예를 들면 다음과 같습니다.
https://searchads360.googleapis.com/v0
https://searchads360.googleapis.com/v1
한 주 버전에서 다른 주 버전으로 업그레이드할 때는 새 주 버전 엔드포인트로 전환하기 전에 코드를 변경해야 할 수 있습니다.
클라이언트 라이브러리를 사용하는 경우 최신 버전으로 업그레이드해야 합니다. 새로운 메이저 버전에서는 코드의 브레이킹 체인지를 수정하는 데 도움이 되는 이전 가이드를 제공합니다.
이전 버전과 호환되지 않는 변경사항의 예는 다음과 같습니다.
- 서비스, 인터페이스, 필드, 메서드 또는 열거형 값의 삭제 또는 이름 변경
- 필드 유형 변경
- 리소스 이름 형식 변경
- HTTP 정의에서 URL 형식 변경
- 출력 형식을 변경합니다(예:
0을 기본값으로 --로 변경).
- 반환된 오류 이유를 A에서 B로 변경합니다.
마이너 버전
마이너 버전에는 하위 호환 변경사항만 도입됩니다.
마이너 버전이 출시되면 이미 사용 중인 엔드포인트가 자동으로 업데이트됩니다. 코드가 중단되지는 않습니다. 기존 클라이언트 라이브러리를 계속 사용할 수 있습니다.
부 버전에는 기존 코드에 영향을 미치지 않는 새로운 기능 또는 업데이트가 포함됩니다. 새 기능을 사용하려면 클라이언트 라이브러리를 최신 버전으로 업그레이드해야 합니다.
일몰
이전 Search Ads 360 Reporting API 버전의 지원이 종료되면 searchads-api-announcements Google 그룹에 알림이 게시됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\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."]]
