시맨틱 버전 관리
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에서는 개발자 블로그 알림을 받을 수 있습니다. 이 지원 중단 일정이 향후 지원 종료와 함께 업데이트됩니다. 날짜.