새 버전이 출시되면 지원 중단된 버전의 지원 종료 날짜가 정해지며, 그 이후에는 더 이상 사용할 수 없습니다. 다음은 유의해야 할 몇 가지 가이드라인입니다.
- 한 번에 최대 3개의 주 버전을 사용할 수 있습니다.
- 주 버전의 수명은 약 12개월이고 부 버전의 수명은 10개월입니다.
- 연간 최대 2회의 업그레이드를 수행해야 하며 엄격한 순차적으로 업그레이드할 필요가 없습니다. 예를 들어 버전 (N)에서 버전 (N+2)로 직접 업그레이드할 수 있습니다.
- 모든 클라이언트 라이브러리가 최신 버전에 출시되는 날짜와 지원 종료 예정인 버전 간의 중복이 최소 20주입니다.
Google의 클라이언트 라이브러리는 사용 가능한 모든 서비스 버전을 지원하므로 사용되는 서비스의 다른 버전을 지정하여 점진적으로 업그레이드할 수 있습니다.
일정
아래 표에는 사용 가능한 각 버전의 구체적인 지원 중단 및 지원 종료 날짜와 향후 버전의 예상 출시일이 나와 있습니다. 출시 후 가능한 한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다.
API 버전 | 출시일 | 지원 중단일 | 지원 소멸일 | 업그레이드 가이드 |
---|---|---|---|---|
v18 | 2024년 9월/10월 | 2025년 1월/2월 | 2025년 9월 | |
v17.1 | 2024년 7월/8월 | 2024년 9월/10월 | 2025년 5월 | |
v17 | 2024년 5월/6월 | 2024년 9월/10월 | 2025년 5월 | |
v16.1 | 2024년 4월 24일 | 2024년 5월/6월 | 2025년 1월 | |
v16 | 2024년 2월 21일 | 2024년 5월/6월 | 2025년 1월 | |
v15 | 2023년 10월 18일 | 2024년 2월 21일 | 2024년 9월 25일 | v15에서 v16으로 업그레이드 |
v14.1 | 2023년 8월 9일 | 2023년 10월 18일 | 2024년 6월 5일 | |
v14 | 2023년 6월 7일 | 2023년 10월 18일 | 2024년 6월 5일 | v14에서 v15로 업그레이드 |
프로젝트에서 사용 중인 버전 보기
Google Cloud Console을 사용하여 프로젝트에서 최근에 호출한 메서드 및 서비스의 목록을 볼 수 있습니다.
- Google Cloud 콘솔에서 API 및 서비스를 엽니다.
- 표에서 Google Ads API를 클릭합니다.
- 측정항목 하위 탭에서 각 그래프에 최근 요청이 표시된 것을 확인할 수 있습니다. 메서드 표에서 요청을 보낸 메서드를 확인할 수 있습니다. 메서드 이름에는 Google Ads API 버전, 서비스, 메서드 이름(예:
google.ads.googleads.v17.services.GoogleAdsService.Mutate
)이 포함됩니다. - (선택사항) 요청을 확인할 기간을 선택합니다.
지원 중단과 지원 종료의 차이점
용어 | 지원 중단 | 일몰 |
---|---|---|
정의 | 지원 중단된 버전은 최신 버전이 아닌 버전입니다. 새 버전이 출시되면 이전 버전은 모두 지원 중단됨으로 표시됩니다. | 지원 종료 버전은 더 이상 사용할 수 없습니다. 이 버전으로 전송된 요청은 지원 종료 날짜 또는 그 이후에 실패합니다. |
결과 | 지원 종료될 때까지는 지원 중단된 버전을 계속 사용할 수 있지만 지원 중단된 버전의 참조는 강조 표시 해제되어 더 이상 최신 버전이 아님을 보여줍니다.
새로운 기능을 활용하려면 최대한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다. |
Google Ads API를 사용하려면 지원 종료 버전에서 즉시 업그레이드해야 합니다.
업그레이드 가이드에 따라 최신 버전으로 업그레이드할 것을 적극 권장합니다. |
타이밍 | 평균적으로 Google은 3~4개월마다 새 버전을 출시하므로 해당 버전은 약 3~4개월 후에 지원 중단됩니다. | Google은 출시 후 1년이 지나면 해당 버전의 지원을 종료하는 것을 목표로 하고 있습니다. |
API | 지원 중단된 버전의 API 엔드포인트는 계속 정상적으로 작동합니다.
클라이언트 라이브러리, REST 등을 사용하여 API 엔드포인트에 액세스할 수 있지만 지원 중단된 버전에는 새로운 기능이 추가되지 않습니다. |
지원 종료된 버전의 API 엔드포인트는 지원 종료일 이후에는 작동이 중지됩니다. 지원 종료 버전의 API 엔드포인트에 액세스하려고 하면 Google Ads API에서 오류가 발생합니다. |
클라이언트 라이브러리 | 간단한 클라이언트 라이브러리를 제공하기 위해 지원 중단 날짜 이후에는 새 클라이언트 라이브러리 버전에 지원 중단된 API 버전이 포함되지 않습니다. 이렇게 하면 클라이언트 라이브러리를 프로젝트에 통합할 때 공간을 절약할 수 있습니다. | 클라이언트 라이브러리는 지원 종료 날짜 이후에는 새로운 클라이언트 라이브러리 버전에서 지원 종료 API 버전을 더 이상 지원하지 않습니다. |
지원 | Google은 지원 중단된 버전을 정기적으로 지원합니다. | 지원 종료된 버전은 지원 종료일 이후에는 더 이상 지원되지 않습니다. |
지원되는 클라이언트 라이브러리 버전
다음 표에는 어떤 클라이언트 라이브러리가 어떤 API 버전과 함께 작동하는지 표시됩니다.
Java
Google Ads API |
자바용 클라이언트 라이브러리 |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
.NET용 클라이언트 라이브러리 |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
2,399필리핀
Google Ads API |
PHP용 클라이언트 라이브러리 |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
Python용 클라이언트 라이브러리 |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
루비
Google Ads API |
Ruby용 클라이언트 라이브러리 |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
Perl용 클라이언트 라이브러리 |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: 21.0.0 |
기능 지원 중단
Google Ads 개발자 블로그를 정기적으로 모니터링하여 지원 중단 예정인 기능에 대한 소식을 가장 먼저 확인하세요.
아래 표에는 현재 Google Ads API에 대해 계획된 특정 기능 지원 중단이 나열되어 있습니다. 각 지원 중단에 관한 자세한 내용은 연결된 블로그 게시물을 참고하세요
특성 | 설명 | 시행일 | 기타 참고사항 |
---|---|---|---|
수수료 입찰 전략 |
Google Ads API에서는
더 이상 COMMISSION 입찰 전략을 사용하는 호텔 캠페인을 만들 수 없습니다
.
|
2024년 4월 30일 |
새 호텔 캠페인을 만들거나 기존 캠페인에 COMMISSION 입찰 전략을 적용하도록 요청하면 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 오류가 발생합니다. COMMISSION 입찰 전략을 사용하는 기존 캠페인은 2024년 10월 31일까지 계속 운영됩니다. 이 날짜 이후에는 입찰 전략이 업데이트될 때까지 캠페인 광고 게재가 중단됩니다.
|