이 가이드에서는 Merchant API가 버전 관리, 출시, 다양한 버전의 수명 주기를 처리하는 방법을 설명합니다.
버전 관리 체계
Merchant API는 하위 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일에 제품 하위 API의 v1이 지원 중단되면 2027년 1월 15일 이후에 지원 종료됩니다. 이 날짜 이후에는 이전 버전의 하위 API를 더 이상 사용할 수 없습니다.
하위 API 버전 및 수명 주기 상태
다음 표에는 Merchant API의 각 하위 API의 최신 버전이 나와 있습니다.
| 하위 API | 알파 버전 | 베타 버전 | 상태 |
|---|---|---|---|
| 계정 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 제품 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 제품 입력 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 로컬 인벤토리 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 리전별 인벤토리 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 데이터 소스 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 프로모션 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 보고서 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 전환 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 알림 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 리뷰 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| 배송 설정 | 사용할 수 없음 | v1 베타 | v1 베타 버전이 활성 상태입니다. |
| Product Studio | v1 알파 | 사용할 수 없음 | v1 알파 버전이 활성화됨 |
권장사항
- 출시 노트와 최신 업데이트에서 새 버전, 주요 업데이트, 개선사항, 하위 API 출시 및 지원 중단에 관한 공지사항을 정기적으로 확인하세요.
- 하위 API에 안정화 버전이 2개 이상 있는 경우 항상 최신 버전을 사용하는 것이 좋습니다.
- 네트워크 문제, 비율 제한, 최신 하위 API 버전에서 도입될 수 있는 새 오류 코드 또는 메시지를 비롯한 다양한 하위 API 오류를 적절하게 처리하도록 애플리케이션을 설계합니다.
- 하위 API 버전이 지원 중단될 때까지 기다리지 말고 업그레이드 계획을 시작하세요. 새 버전이 출시되는 즉시 평가 및 테스트를 시작합니다.
- 하위 API 로드맵에 관한 기능 요청이나 우려사항이 있는 경우 문의사항이나 의견을 보내주세요. Merchant API팀에 기술 지원을 요청하는 방법에 관한 자세한 내용은 Merchant API 관련 도움말을 참고하세요.