버전 관리

시맨틱 버전 관리

Google Ads API는 주 버전과 부 버전이 있는 시맨틱 버전 관리를 따릅니다. 버전의 형식은 MAJOR.MINOR 또는 vMAJOR_MINOR입니다. 예를 들어 v12_0은 메이저 버전이고 v12_1는 부 버전입니다.

이전 버전은 출시 노트를 참고하세요.

메이저 버전

주요 출시 버전에서 이전 버전과 호환되지 않는 브레이킹 체인지가 발생합니다. 버전은 0으로 끝나며 vX_0 형식으로 표시됩니다. 여기서 X는 주 버전 번호입니다.

메이저 버전에는 별도의 엔드포인트가 있습니다. X가 메이저 버전 번호인 URL의 예입니다.

https://googleads.googleapis.com/vX

이전 메이저 버전에서 업그레이드하는 경우 새 메이저 버전 엔드포인트로 전환할 때 코드를 변경해야 할 수 있습니다. 클라이언트 라이브러리를 사용 중인 경우 최신 버전으로 업그레이드하세요. 메이저 버전이 출시되면 코드의 브레이킹 체인지를 수정하기 위해 진행해야 하는 이전 가이드가 제공됩니다.

브레이킹 체인지의 예는 다음과 같습니다.

  • 서비스, 인터페이스, 필드, 메서드 또는 enum 값을 삭제하거나 이름을 바꿉니다.
  • 필드 유형 변경
  • 리소스 이름 형식 변경
  • HTTP 정의에서 URL 형식 변경
  • 출력 형식을 0에서 --로 기본값으로 변경하는 등의 변경
  • A에서 B로 반환된 오류 이유를 변경합니다.

마이너 버전

부 버전에는 이전 버전과 호환되는 변경사항만 도입됩니다. 부 버전의 경우 vMAJOR_MINORMINOR 번호는 0보다 큽니다.

부 버전이 출시되면 이미 사용 중인 엔드포인트가 자동으로 업데이트됩니다. 이로 인해 코드가 손상되지는 않습니다. 기존 클라이언트 라이브러리는 계속 사용할 수 있습니다.

부 버전에는 기존 코드에 영향을 주지 않는 새로운 기능이나 업데이트가 포함되어 있습니다. 이러한 새 기능을 사용하려면 클라이언트 라이브러리를 최신 버전으로 업그레이드하세요.

일몰

이전 Google Ads API 버전은 주기적으로 지원이 중단될 예정입니다. 버전이 지원 중단되는 시점에 개발자 블로그에 공지를 게시하겠습니다. 지원 중단 일정이 향후 서비스 종료 날짜로 업데이트됩니다.