Search Ads 360 Reporting API의 버전 관리

Search Ads 360 Reporting API는 시맨틱 버전 관리를 사용합니다.

vMAJOR_MINOR 형식의 메이저 버전과 마이너 버전이 있습니다. 예를 들어 v0_0은 첫 번째 메인 버전이고 v0_1은 첫 번째 마이너 버전입니다. 버전 번호의 접미사는 버전 유형을 나타냅니다. 주 버전의 경우 항상 0이고 부 버전의 경우 항상 0보다 큽니다.

주요 버전

주요 출시에는 이전 버전과 호환되지 않는 브레이킹 체인지, 즉 변경사항이 도입됩니다.

주 버전마다 별도의 엔드포인트가 있습니다. 예를 들면 다음과 같습니다.

https://searchads360.googleapis.com/v0

https://searchads360.googleapis.com/v1

한 주 버전에서 다른 주 버전으로 업그레이드할 때는 새 주 버전 엔드포인트로 전환하기 전에 코드를 변경해야 할 수 있습니다.

클라이언트 라이브러리를 사용하는 경우 최신 버전으로 업그레이드해야 합니다. 새로운 메이저 버전에서는 코드의 브레이킹 체인지를 수정하는 데 도움이 되는 이전 가이드를 제공합니다.

이전 버전과 호환되지 않는 변경사항의 예는 다음과 같습니다.

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

마이너 버전

마이너 버전에는 하위 호환 변경사항만 도입됩니다.

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

부 버전에는 기존 코드에 영향을 미치지 않는 새로운 기능 또는 업데이트가 포함됩니다. 새 기능을 사용하려면 클라이언트 라이브러리를 최신 버전으로 업그레이드해야 합니다.

일몰

이전 Search Ads 360 Reporting API 버전의 지원이 종료되면 searchads-api-announcements Google 그룹에 알림이 게시됩니다.