이 가이드에서는 Merchant API가 버전 관리, 출시, 다양한 버전의 수명 주기를 처리하는 방법을 설명합니다.
버전 관리 체계
Merchant API는 하위 API 수준에서 버전 관리 전략을 사용합니다. 즉, 각 Merchant API(예: Merchant API 내의 제품)에는 자체 버전 수명 주기가 있습니다.
버전 관리 형식 및 표시
안정적인 하위 API 버전: 하위 API가 안정적인 버전에 있으면 모든 메서드가 안정적인 버전에 있습니다. 안정적인 하위 API 버전은 vX (예: v1, v2)로 표시됩니다. 프로덕션에 즉시 사용 가능한 메이저 버전입니다.
알파 하위 API 버전: 하위 API가 알파 버전인 경우 모든 메서드가 알파 버전입니다. 알파 하위 API 버전은 vXalpha (예: v1alpha, v2alpha)로 표시됩니다. 여기에는 테스트 및 빠른 반복을 위한 실험용 사전 체험판 기능이 포함되어 있습니다. 알파 버전은 안정성이 보장되지 않고 정의된 수명이 없으며 30일의 고지 기간을 거쳐 변경되거나 중단될 수 있습니다.
버전 변경사항
- 메이저 버전 증가 (예: v1에서 v2로): 이전 버전과 호환되지 않는 브레이킹 체인지를 나타내며 개발자의 조치가 필요합니다. 안정적인 하위 API의 브레이킹 체인지에만 새 버전 번호가 부여됩니다. 예를 들어 v1에서 v2로 업그레이드합니다.
- 마이너 변경사항: 하위 호환 추가 또는 수정사항은 기존 메이저 버전의 변경사항으로 표시됩니다. 이러한 변경사항은 해당 메이저 버전의 출시 노트에 자세히 설명되어 있습니다. 하위 API에 대한 비브레이킹 추가는 최신 안정화 버전의 알파 채널 또는 최신 안정화 버전에 직접 출시됩니다.
지원 종료 정책
Google은 이전 판매자 하위 API 버전을 주기적으로 지원 중단합니다. Google은 공식 지원 중단 발표를 시작으로 안정적인 메이저 버전 (vX)에 대해 12개월의 지원 중단 기간을 제공합니다.
예를 들어 2026년 1월 15일에 Products 하위 API의 v1을 지원 중단하는 경우 2027년 1월 15일 이후에 지원이 종료됩니다. 이 날짜 이후에는 이전 버전의 하위 API를 더 이상 사용할 수 없습니다.
하위 API 버전 및 수명 주기 상태
다음 표에는 Merchant API의 각 하위 API의 최신 버전이 나와 있습니다.
| 하위 API | 버전 | 상태 |
|---|---|---|
| 계정 | v1 v1alpha |
활성 활성 |
| 전환수 | v1 | 활성 |
| 데이터 소스 | v1 | 활성 |
| 인벤토리 | v1 | 활성 |
| 문제 해결 | v1 | 활성 |
| 오프라인 제품 피드 파트너십 | v1 | 활성 |
| 알림 | v1 | 활성 |
| 주문 추적 | v1 | 활성 |
| 제품 | v1 | 활성 |
| Product Studio | v1alpha | 활성 |
| 프로모션 | v1 | 활성 |
| 할당량 | v1 | 활성 |
| 보고서 | v1 | 활성 |
| 리뷰 | v1alpha | 활성 |
권장사항
- 출시 노트와 최신 업데이트를 정기적으로 확인하여 새 버전, 주요 업데이트, 개선사항, 하위 API 출시 및 지원 중단에 관한 공지사항을 확인하세요.
- 하위 API에 안정화 버전이 두 개 이상 있는 경우 항상 최신 버전을 사용하는 것이 좋습니다.
- 네트워크 문제, 비율 제한, 최신 하위 API 버전에 도입될 수 있는 새로운 오류 코드 또는 메시지를 비롯한 다양한 하위 API 오류를 원활하게 처리하도록 애플리케이션을 설계합니다.
- 하위 API 버전이 지원 중단될 때까지 기다리지 말고 업그레이드 계획을 세우세요. 새 버전이 출시되는 즉시 평가 및 테스트를 시작합니다.
- 하위 API 로드맵에 관한 기능 요청이나 우려사항이 있는 경우 질문이나 의견을 보내주세요. 기술 지원을 위해 Merchant API팀에 문의하는 방법에 대한 자세한 내용은 Merchant API 관련 도움받기를 참조하세요.