지원 중단 및 지원 종료

새 버전이 출시됨에 따라 지원 중단된 버전의 서비스 종료 날짜가 정해지며, 그 이후에는 해당 버전을 더 이상 사용할 수 없습니다. 그 외에 유의해야 할 가이드라인은 다음과 같습니다.

  • 한 번에 최대 3개의 주요 버전을 사용할 수 있습니다.
  • 주 버전의 수명은 약 12개월(마이너 버전: 10개월)입니다.
  • 연간 최대 2개의 업그레이드를 수행해야 하며 엄격한 순차적인 순서로 업그레이드할 필요가 없습니다. 예를 들어 버전 (N)에서 버전 (N+2)으로 직접 업그레이드할 수 있습니다.
  • 최신 버전에 대해 모든 클라이언트 라이브러리가 릴리스되는 날짜와 지원 종료될 버전 사이의 겹침이 20주 이상입니다.

클라이언트 라이브러리는 사용 가능한 모든 버전의 서비스를 지원하므로 사용된 서비스의 다른 버전을 지정하여 점진적으로 업그레이드할 수 있습니다.

일정

아래 표에는 사용 가능한 버전별 구체적인 지원 중단일 및 서비스 종료일과 향후 버전의 예상 출시일이 나와 있습니다. 출시 후 가능한 한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다.

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을 사용하여 프로젝트에서 최근에 호출한 메서드 및 서비스의 목록을 볼 수 있습니다.

  1. Google Cloud 콘솔에서 API 및 서비스를 엽니다.
  2. 표에서 Google Ads API를 클릭합니다.
  3. 측정항목 하위 탭에서 각 그래프에 표시된 최근 요청을 확인할 수 있습니다. 메서드 테이블에서 요청을 보낸 메서드를 확인할 수 있습니다. 메서드 이름에는 Google Ads API 버전, 서비스, 메서드 이름(예: google.ads.googleads.v16.services.GoogleAdsService.Mutate)이 포함됩니다.
  4. (선택사항) 요청에 대해 확인할 기간을 선택합니다.

지원 중단과 지원 종료의 차이점

용어지원 중단일몰
정의 지원 중단된 버전은 최신 버전이 아닌 버전입니다. 새 버전이 출시되면 모든 이전 버전이 지원 중단됨으로 표시됩니다. 지원 종료 버전은 더 이상 사용할 수 없습니다. 이 버전으로 전송된 요청은 지원 종료일 또는 그 이후에 실패합니다.
영향 지원 중단된 버전은 서비스 종료될 때까지 계속 사용할 수 있지만 지원 중단된 버전의 참조는 강조표시 해제되어 더 이상 최신 버전이 아님을 나타냅니다.

새로운 기능을 활용하려면 가능한 한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다.

Google Ads API를 사용하려면 지원 종료된 버전에서 즉시 업그레이드해야 합니다.

업그레이드 가이드를 사용하여 최신 버전으로 업그레이드할 것을 적극 권장합니다.

타이밍 평균적으로 3~4개월마다 새 버전을 출시하므로 해당 버전은 약 3~4개월 후에 지원 중단됩니다. 출시 후 1년이 지나면 지원 종료되는 것을 목표로 하고 있습니다.
API 지원 중단된 버전의 API 엔드포인트는 여전히 정상 작동합니다.

클라이언트 라이브러리, REST 등을 사용하여 API 엔드포인트에 액세스할 수 있지만 지원 중단된 버전에는 새로운 기능이 추가되지 않습니다.

지원 종료일 이후에는 지원 종료 버전의 API 엔드포인트가 작동을 중단합니다. 지원 종료된 버전의 API 엔드포인트에 액세스하려고 하면 Google Ads API에서 오류가 발생합니다.
클라이언트 라이브러리 압축 클라이언트 라이브러리를 제공하기 위해 지원 중단일 이후에는 지원 중단된 API 버전을 새 클라이언트 라이브러리 버전에 더 이상 포함하지 않을 예정입니다. 따라서 클라이언트 라이브러리를 프로젝트에 통합할 때 공간을 절약할 수 있습니다. 지원 종료일 이후에는 클라이언트 라이브러리가 새 클라이언트 라이브러리 버전에서 지원 종료 API 버전을 더 이상 지원하지 않습니다.
지원 Google에서는 지원 중단된 버전을 정기적으로 지원합니다. 지원 종료 버전은 지원 종료일 이후에는 더 이상 지원되지 않습니다.

지원되는 클라이언트 라이브러리 버전

다음 표에서는 어떤 클라이언트 라이브러리가 어떤 API 버전과 함께 작동하는지 보여줍니다.

Java

자바용 클라이언트 라이브러리
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: -
v14 Min: 26.0.0
Max: -

C#

.NET용 클라이언트 라이브러리
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: -
v14 Min: 16.1.0
Max: -

2,399필리핀

PHP용 클라이언트 라이브러리
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: -
v14 Min: 19.2.0
Max: -

Python

Python용 클라이언트 라이브러리
v16 Min: 23.1.0
Max: -
v15 Min: 22.1.0
Max: -

Ruby

Ruby용 클라이언트 라이브러리
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -
v14 Min: 23.0.0
Max: -

Perl

Perl용 클라이언트 라이브러리
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -
v14 Min: 17.0.0
Max: -

기능 지원 중단

Google Ads 개발자 블로그를 정기적으로 모니터링하여 예정된 기능 지원 중단 소식을 가장 먼저 확인하세요.

아래 표에는 현재 Google Ads API에 예정된 구체적인 기능 지원 중단이 나와 있습니다. 각 지원 중단에 관한 자세한 내용은 연결된 블로그 게시물에서 확인할 수 있습니다.

특성 설명 시행일 기타 참고사항
수수료 입찰 전략 Google Ads API에서는 COMMISSION 입찰 전략을 사용한 호텔 캠페인 생성을 더 이상 지원하지 않습니다 . 2024년 4월 30일 새 호텔 캠페인을 만들거나 기존 캠페인에 COMMISSION 입찰 전략을 적용하도록 요청하면 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 오류가 발생합니다. COMMISSION 입찰 전략을 사용하는 기존 캠페인은 2024년 10월 31일까지 계속 운영됩니다. 이 날짜가 지나면 입찰 전략이 업데이트될 때까지 캠페인의 광고 게재가 중단됩니다.