버전 관리

시맨틱 버전 관리

Google Ads API는 시맨틱 버전 관리를 따르며, 여기에는 두 가지 방법으로 나뉩니다 버전 형식은 MAJOR.MINOR 또는 vMAJOR_MINOR입니다. 예를 들어 v17_0은 주 버전이지만 v17_1은(는) 부 버전입니다.

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

주 버전

주요 출시 버전에는 이전 버전과 호환되지 않는 브레이킹 체인지가 포함되어 있습니다. 버전은 0으로 끝나며 vX_0 형식으로 끝납니다. 여기서 X는 메이저입니다. 확인할 수 있습니다

주 버전마다 별도의 엔드포인트가 있습니다. 이것은 X는 주 버전 번호입니다.

https://googleads.googleapis.com/vX

이전 메이저 버전에서 업그레이드하는 경우 코드에 새로운 주 버전 엔드포인트로 전환하면 변경사항이 적용되지 않습니다 Google의 클라이언트 라이브러리를 다운로드한 다음 최신 버전으로 업그레이드하세요. 메이저 버전이 출시되면 코드의 브레이킹 체인지를 수정해야 합니다.

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

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

마이너 버전

부 버전은 이전 버전과 호환되는 변경사항만 도입합니다. 마이너 버전의 경우 vMAJOR_MINOR은 0보다 큰 MINOR 숫자를 갖게 됩니다.

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

마이너 버전에는 만들 수 있습니다 이러한 새 기능을 사용하려면 클라이언트 라이브러리를 최신 버전으로 업데이트합니다.

일몰

주기적으로 이전 Google Ads API 버전은 서비스 종료됩니다. Google에서는 개발자 블로그 알림을 받을 수 있습니다. 이 지원 중단 일정이 향후 지원 종료와 함께 업데이트됩니다. 날짜.