지원 중단 및 지원 종료

새로운 버전이 출시됨에 따라 종료 날짜가 주어지면 해당 버전은 더 이상 있습니다. 다음은 유의해야 할 몇 가지 가이드라인입니다.

  • 한 번에 최대 3개의 주 버전을 사용할 수 있습니다.
  • 버전의 수명은 약 12개월( 버전)입니다. 10개월
  • 1년에 최대 2번까지 업그레이드를 수행해야 하며 엄격한 순서대로 업그레이드하는 것이 좋습니다. 예를 들어 버전 (N)에서 버전 (N+2)로 직접 이동할 수 있습니다.
  • 다음 대상의 모든 클라이언트 라이브러리가 릴리스되는 날짜 간의 중복 최신 버전 및 지원 종료 예정인 버전이 20주 이상 되어야 합니다.

클라이언트 라이브러리는 사용할 수 있는 다양한 버전의 서비스를 지정하여 점진적으로 제공합니다

일정

아래 표에는 각 서비스의 구체적인 지원 중단일 및 지원 종료 날짜가 나와 있습니다. 버전, 향후 버전의 예상 출시일이 표시됩니다. 최신 버전으로 업그레이드한 후 최대한 빠른 시일 내에 있습니다.

API 버전 출시일 지원 중단일 지원 소멸일 업그레이드 가이드
v18 2024년 9월/10월 2025년 1월/2월 2025년 9월
v17.1 2024년 8월 7일 2024년 9월/10월 2025년 5월
v17 2024년 6월 5일 2024년 9월/10월 2025년 5월
v16.1 2024년 4월 24일 2024년 5월/6월 2025년 1월
v16 2024년 2월 21일 2024년 5월/6월 2025년 1월 v16에서 v17로 업그레이드
v15 2023년 10월 18일 2024년 2월 21일 2024년 9월 25일 v15에서 v16으로 업그레이드

프로젝트에서 사용 중인 버전 보기

프로젝트에서 최근에 호출한 메서드 및 서비스의 목록을 볼 수 있습니다. Google Cloud 콘솔을 사용하여 다음을 수행합니다.

  1. API 및 '서비스'로 이동합니다.
  2. 표에서 Google Ads API를 클릭합니다.
  3. METRICS 하위 탭에 최근 요청이 살펴보겠습니다 요청을 보낸 메서드는 메서드 표. 메서드 이름 Google Ads API 버전, 서비스, 메서드 이름(예: google.ads.googleads.v17.services.GoogleAdsService.Mutate
  4. (선택사항) 요청을 확인할 기간을 선택합니다.

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

용어지원 중단일몰
정의 지원 중단된 버전은 최신 버전이 아닌 버전입니다. 새 버전이 출시되면 모든 이전 버전이 표시됩니다. 지원 중단되었습니다. 지원 종료 버전은 더 이상 사용할 수 없습니다. 이 주소로 전송된 요청 지원 종료 날짜 또는 그 이후에 서비스가 실패하게 됩니다.
결과 지원 종료될 때까지는 지원 중단된 버전을 계속 사용할 수 있습니다. 지원 중단된 버전의 참조는 강조 표시되지 않아 강조 표시되지 않습니다. 더 이상 최신 버전이 아님을 확인합니다.

최대한 빨리 최신 버전으로 업그레이드하여 새로운 기능을 활용할 수 있습니다.

다음 기간 이후 지원 종료 버전에서 즉시 업그레이드해야 합니다. Google Ads API를 사용할 수 있습니다.

최신 버전으로 업그레이드할 것을 적극 권장합니다. 버전을 참조하세요(업그레이드 가이드 사용).

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

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

지원 종료 버전용 API 엔드포인트 작업 중지 지원 종료 날짜 Google Ads API에서 지원 종료 버전의 API 엔드포인트
클라이언트 라이브러리 컴팩트 클라이언트 라이브러리를 제공하기 위해 새 클라이언트 라이브러리 버전에 지원 중단된 API 버전 포함 더 이상 사용되지 않습니다 이렇게 하면 통합 시 공간을 절약할 수 있습니다. 클라이언트 라이브러리를 사용할 수 있습니다. 클라이언트 라이브러리는 지원 종료 API 버전을 더 이상 지원하지 않습니다. 지원 종료 날짜 이후에는 새로운 클라이언트 라이브러리 버전을 업데이트할 수 있습니다
지원 Google은 지원 중단된 버전을 정기적으로 지원합니다. 지원 종료 버전은 지원 종료 후 더 이상 지원되지 않습니다. 있습니다.

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

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

자바

자바용 클라이언트 라이브러리
v17 Min: 32.0.0
Max:~
v16 Min: 30.0.0
Max:~
v15 Min: 28.0.0
Max: 32.0.0

C#

.NET용 클라이언트 라이브러리
v17 Min: 20.1.0
Max:~
v16 Min: 18.1.0
Max:~
v15 Min: 17.1.0
Max: 20.1.0

PHP

PHP용 클라이언트 라이브러리
v17 Min: 23.1.0
Max:~
v16 Min: 22.1.0
Max:~
v15 Min: 21.1.0
Max: 23.1.0

Python

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

Ruby

Ruby용 클라이언트 라이브러리
v17 Min: 29.0.0
Max:~
v16 Min: 27.0.0
Max:~
v15 Min: 25.0.0
Max:~

Perl

Perl용 클라이언트 라이브러리
v17 Min: 23.0.0
Max:~
v16 Min: 21.0.0
Max:~
v15 Min: 19.0.0
Max:~

기능 지원 중단

정기적으로 Google Ads 개발자 블로그 모니터링 입니다.

아래 표에는 현재 지원 중단된 특정 기능이 나와 있습니다. 계획되어 있습니다. 각 지원 중단에 대한 자세한 내용은 확인할 수 있습니다. 블로그 게시물에서 확인할 수 있습니다.

기능 설명 시행일 추가 참고사항
수수료 입찰 전략 Google Ads API COMMISSION을(를) 사용한 호텔 캠페인 생성을 더 이상 지원하지 않습니다. 입찰 전략 2024년 4월 30일 새 호텔 캠페인 생성 또는 COMMISSION 적용 요청 입찰 전략을 기존 캠페인에 추가하면 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 오류가 발생했습니다. COMMISSION 입찰을 사용하는 기존 캠페인 2024년 10월 31일까지 계속 유지됩니다. 이날 이후 캠페인에서 입찰 전략이 업데이트될 때까지 광고 게재가 중단됩니다.