시맨틱 버전 관리
Google Ads API는 주 버전 번호와 마이너 버전 번호가 있는 시맨틱 버전 관리를 따릅니다. 버전은 MAJOR.MINOR 또는 vMAJOR.MINOR로 작성됩니다.
예를 들어 v26.0 (또는 v26)은 메이저 버전이고 v26.1은 마이너 버전입니다.
현재 및 이전 버전에 관한 자세한 내용은 출시 노트를 참고하세요.
메이저 버전
주요 출시 버전에는 이전 버전과 호환되지 않는 브레이킹 체인지가 도입됩니다. 메이저 버전의 초기 버전은 0으로 끝납니다 (vX.0 또는 vX, 여기서 X는 메이저 버전 번호).
각 메이저 버전에는 별도의 REST 및 gRPC 엔드포인트 경로 (vX)가 있으며, 여기에는 마이너 버전 서픽스가 포함되지 않습니다. 다음 URL에서 X은 메이저 버전 번호입니다 (예: v26).
https://googleads.googleapis.com/vX
이전 메이저 버전에서 업그레이드하는 경우 새 메이저 버전 엔드포인트로 전환할 때 코드를 변경해야 할 수 있습니다. 클라이언트 라이브러리를 사용하는 경우 새 메이저 버전을 지원하는 클라이언트 라이브러리 출시 버전으로 업그레이드합니다. 메이저 버전이 출시되면 코드의 브레이킹 체인지를 해결하는 데 도움이 되는 업그레이드 가이드가 제공됩니다.
브레이킹 체인지의 예는 다음과 같습니다.
- 서비스, 인터페이스, 필드, 메서드 또는 enum 값의 삭제 또는 이름 변경
- 필드 유형 변경
- 리소스 이름 형식 변경
- HTTP 정의에서 URL 형식 변경
- 기본값 변경과 같은 출력 형식 변경
- 반환되는 오류 이유를 A에서 B로 변경합니다.
마이너 버전
마이너 버전에는 이전 버전과 호환되는 변경사항만 포함됩니다. 마이너 버전의 경우 vMAJOR.MINOR의 MINOR 숫자가 0보다 큽니다 (예: v26.1).
마이너 버전이 출시되면 기존 메이저 버전 엔드포인트(https://googleads.googleapis.com/vX)가 자동으로 업데이트됩니다. 엔드포인트 URL에서 버전 경로를 변경할 필요가 없으며 기존 코드가 중단 없이 계속 작동합니다.
마이너 버전은 기존 코드에 영향을 미치지 않는 기능이나 업데이트를 추가합니다. 클라이언트 라이브러리에서 마이너 버전의 필드 또는 기능을 사용하려면 클라이언트 라이브러리를 마이너 버전 정의가 포함된 출시 버전으로 업그레이드하세요.
지원 중단 및 지원 종료
이전 Google Ads API 버전은 주기적으로 지원 중단되고 이후 지원 종료됩니다.
- 지원 중단됨: 메이저 버전 (예:
v26)이 출시되면 이전의 모든 메이저 버전이 지원 중단됨으로 표시됩니다. 지원 중단된 버전에 대한 API 호출은 지원 종료일까지 계속 성공하며 기존 클라이언트 라이브러리 출시 버전은 계속 지원하지만, 이후 클라이언트 라이브러리 출시 버전에서는 패키지 크기를 줄이기 위해 지원 중단된 API 버전을 생략합니다. - 지원 종료: 지원 종료일에 버전이 사용 중지되고 엔드포인트에 대한 모든 API 호출이 실패합니다.
Google은 버전 지원 종료 전에 개발자 블로그에 공지사항을 게시합니다. 활성, 지원 중단, 예정된 지원 종료 날짜는 지원 중단 및 지원 종료 일정을 확인하세요.