Merchant API v1beta는 2026년 2월 28일에 지원 중단되고 종료되었습니다. 안정적인 최신 버전으로 전환하는 단계는 v1beta에서 v1로 마이그레이션을 참고하세요.

버전 관리

이 가이드에서는 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은 이전 Merchant 하위 API 버전을 정기적으로 지원 종료합니다. Google은 공식 지원 종료 공지부터 시작하여 안정적인 주 버전 (vX)에 대해 12개월의 지원 중단 기간을 약속합니다.

예를 들어 2026년 1월 15일에 제품 하위 API의 v1을 지원 중단하는 경우 2027년 1월 15일 이전에 지원 종료되지 않습니다. 이 날짜 이후에는 이전 버전의 하위 API를 더 이상 사용할 수 없습니다.

다음 표에는 Merchant API의 각 하위 API의 최신 버전이 나와 있습니다.

출시 노트와 최신 업데이트 를 정기적으로 확인하여 새 버전, 주요 업데이트, 개선사항, 하위 API 출시 및 지원 중단에 관한 공지를 확인하세요.
하위 API에 안정적인 버전이 두 개 이상 있는 경우 항상 최신 버전을 사용하는 것이 좋습니다.
네트워크 문제, 비율 제한, 최신 하위 API 버전에서 도입될 수 있는 새로운 오류 코드 또는 메시지를 비롯한 다양한 하위 API 오류를 정상적으로 처리하도록 애플리케이션을 설계하세요.
하위 API 버전이 지원 종료될 때까지 기다리지 말고 업그레이드 계획을 세우세요. 새 버전이 제공되는 즉시 평가하고 테스트를 시작하세요.
하위 API 로드맵에 관한 기능 요청 또는 우려사항이 있는 경우 질문이나 의견을 보내주세요. 기술 지원을 위해 Merchant API팀에 문의하는 방법에 관한 자세한 내용은 Merchant API 관련 도움말을 참고하세요.