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