버전 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드에서는 Merchant API가 버전 관리, 출시, 다양한 버전의 수명 주기를 처리하는 방법을 설명합니다.
버전 관리 체계
Merchant API는 하위 API 수준에서 버전 관리 전략을 사용합니다. 즉, Merchant API 내의 제품과 같은 각 API에는 자체 버전 수명 주기가 있습니다.
안정적인 하위 API 버전: 하위 API가 안정적인 버전인 경우 모든 메서드가 안정적인 버전입니다. 안정적인 하위 API 버전은 vX (예: v1, v2)로 표시됩니다. 이는 프로덕션 준비가 완료된 주요 버전입니다.
알파 하위 API 버전: 하위 API가 알파에 있으면 모든 메서드가 알파에 있습니다. 알파 하위 API 버전은 vXalpha (예: v1alpha, v2alpha)로 표시됩니다. 여기에는 테스트 및 빠른 반복을 위한 실험적인 사전 체험판 기능이 포함되어 있습니다. 알파 버전은 안정성이 보장되지 않으며 수명이 정의되어 있지 않고 30일의 공지 기간을 두고 변경되거나 지원이 중단될 수 있습니다.
버전 변경사항
주 버전 증가 (예: v1에서 v2): 이전 버전과 호환되지 않는 브레이킹 체인지를 나타내며 개발자 조치가 필요합니다.
안정적인 하위 API의 브레이킹 체인지에만 새 버전 번호가 부여됩니다. 예를 들어 v1에서 v2로
사소한 변경사항: 하위 호환되는 추가사항이나 수정사항은 기존 주 버전의 변경사항으로 표시됩니다. 이러한 변경사항은 해당 주요 버전의 출시 노트에 자세히 설명됩니다. 하위 API에 대한 호환성이 깨지지 않는 추가사항은 최신 안정화 버전의 알파 채널에 출시되거나 최신 안정화 버전에 직접 출시됩니다.
지원 종료 정책
Google에서는 오래된 Merchant 하위 API 버전을 주기적으로 지원 중단합니다. 공식 지원 중단 발표가 시작된 후 안정적인 주요 버전 (vX)의 12개월 지원 중단 기간을 약속합니다.
예를 들어 2026년 1월 15일에 제품 하위 API의 v1이 지원 중단되면 2027년 1월 15일 이후에 지원이 종료됩니다. 이 날짜 이후에는 이전 버전의 하위 API를 더 이상 사용할 수 없습니다.
하위 API 버전 및 수명 주기 상태
다음 표에는 Merchant API의 각 하위 API의 최신 버전이 나와 있습니다.
| 하위 API |
버전 |
상태 |
| 계정 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 전환수 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 데이터 소스 |
v1
v1beta |
활성
2026년 2월 28일에 지원 중단 예정 |
| 재고 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 문제 해결 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 오프라인 제품 피드 파트너십 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 알림 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 주문 추적 | v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 제품 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| Product Studio |
v1alpha |
활성 |
| 프로모션
|
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 할당량 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 보고 |
v1
v1beta |
활성
2026년 2월 28일에 중단됨 |
| 리뷰 |
v1alpha
v1 베타 |
활성
2026년 2월 28일에 중단됨 |
권장사항
- 출시 노트와 최신 업데이트를 정기적으로 확인하여 새 버전, 주요 업데이트, 개선사항, 하위 API 출시 및 지원 중단에 관한 공지사항을 확인하세요.
- 하위 API에 안정화 버전이 두 개 이상 있는 경우 항상 최신 버전을 사용하는 것이 좋습니다.
- 네트워크 문제, 비율 제한, 최신 하위 API 버전에서 도입될 수 있는 새로운 오류 코드 또는 메시지 등 다양한 하위 API 오류를 정상적으로 처리하도록 애플리케이션을 설계하세요.
- 하위 API 버전이 지원 종료될 때까지 기다리지 말고 업그레이드 계획을 시작하세요. 새 버전이 제공되는 즉시 평가하고 테스트를 시작합니다.
- 기능 요청이나 하위 API 로드맵에 관한 우려사항이 있는 경우 문의나 의견을 보내주세요. 기술 지원을 위해 Merchant API팀에 문의하는 방법에 관한 자세한 내용은 Merchant API 관련 도움 받기를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-22(UTC)
[null,null,["최종 업데이트: 2025-08-22(UTC)"],[],[],null,["# Versioning\n\nThis guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n-----------------\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\n### Versioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\n### Version changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API will\n be released to the alpha channel of the latest stable version or directly to\n the latest stable version.\n\nSunset policy\n-------------\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n------------------------------------\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reporting | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n--------------\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
