일부 비즈니스 프로필 API는 두 개 이상의 버전과 출시 채널에서 사용할 수 있습니다. 버전은 v1 또는 v1alpha와 같이 호스트 이름 뒤에 오는 요청 URL의 세그먼트입니다. 이 페이지에서는 버전 번호 지정 방법, 각 출시 채널의 안정성, 알파 채널 호출 방법을 설명합니다.
버전 번호 지정
각 API 버전에는 메이저 버전 번호와 선택적 채널 서픽스가 있습니다.
- 메이저 버전 (
v1,v2, …): 안정적인 정식 버전입니다. 메이저 버전은 새 메서드, 새 필드, 새 enum 값과 같은 하위 호환 변경사항만 수신합니다. 이전 버전과 호환되지 않는 변경사항은 새 메이저 버전으로 출시됩니다. - 알파 채널 (
v1alpha,v2alpha, …): 메이저 버전의 출시 전 채널입니다. 여기에는 해당 메이저 버전의 모든 기능과 아직 정식 버전으로 출시되지 않은 기능이 포함됩니다.
출시 채널
| 채널 | 안정성 | 목차 |
|---|---|---|
정식 버전 (v1) |
안정적입니다. 메이저 버전 내의 변경사항은 하위 호환됩니다. 메이저 버전이 지원 중단되면 지원 중단 발표 후 최소 12개월 동안 사용할 수 있습니다. 지원 중단 및 지원 종료 날짜는 지원 중단 일정 페이지에 게시됩니다. | 정식 버전 기능 |
알파 (v1alpha) |
출시 전 버전으로, 안정성 보장 및 정의된 수명이 없습니다. 알파 기능은 최소 30일 전에 공지한 후 변경되거나 중단될 수 있습니다. 프로덕션 통합에서는 알파 기능을 사용하지 마세요. | v1의 모든 기능과 아직 정식 버전으로 출시되지 않은 기능이 포함됩니다. |
채널 간 기능 이동 방식
기능이 v1alpha에서 v1로 전환되면 v1alpha에서 계속 사용할 수 있습니다.
v1alpha에서만 사용할 수 있는 기능의 가이드 및 참조 페이지는 알파로 표시됩니다. 새로운 알파 및 정식 버전 기능과 알파 기능의 변경 또는 삭제는 최신 업데이트 및 각 API의 변경 로그에 공지됩니다.
알파 채널 사용
알파 채널을 호출하려면 요청 URL에서 v1를 v1alpha로 바꿉니다. 예를 들면 다음과 같습니다.
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}?readMask={readMask}
두 채널 모두 동일한 API에 속하므로 다음을 공유합니다.
- Google Cloud 콘솔에서 API 사용 설정
- OAuth 2.0 범위 및 액세스 요구사항
- 리소스 이름입니다(예:
locations/{locationId}). - 할당량
v1및v1alpha에 대한 요청은 동일한 프로젝트별 할당량에 반영됩니다. 자세한 내용은 할당량 한도를 참조하세요. - 기본 비즈니스 데이터
v1alpha를 통해 변경한 사항은v1를 통해 표시되며 그 반대의 경우도 마찬가지입니다.
클라이언트 라이브러리와 공개 API 디렉터리에는 v1만 포함됩니다. v1alpha를 호출하려면 REST 요청을 직접 전송합니다.
권장사항
- 프로덕션 통합에는
v1과 같은 안정화 버전을 사용하세요. v1alpha와 같은 알파 채널을 사용하여 정식 버전으로 출시되기 전에 새로운 기능을 채택합니다. 의견을 공유하려면 지원을 참조하세요.- 클라이언트가 인식하지 못하는 필드와 enum 값을 허용하도록 합니다.
- 알파 기능을 기반으로 빌드하기 전에 가이드와 변경 로그에서 알려진 제한사항을 확인하세요.