지원 중단 및 지원 종료

새 버전이 출시되면 지원 중단된 버전의 지원 종료 날짜가 정해지며, 그 이후에는 더 이상 사용할 수 없게 됩니다. 다음은 기타 유의해야 할 사항입니다.

• Google은 한 번에 최대 4개의 메이저 버전을 제공하기 위해 노력하고 있습니다.
• 주 버전의 수명은 약 12개월이며 부 버전의 수명은 10개월입니다.
• 연간 최대 2회 업그레이드를 수행해야 하며 엄격한 순서로 업그레이드하지 않아도 됩니다. 예를 들어 버전 (N)에서 버전 (N+2)로 직접 업그레이드할 수 있습니다.
• 모든 클라이언트 라이브러리가 최신 버전으로 출시되는 날짜와 지원이 종료되는 버전 간의 중복 기간은 최소 20주입니다.

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

일정

다음 표에는 사용 가능한 각 버전의 구체적인 지원 중단일 및 서비스 종료일과 향후 버전의 예상 출시일이 나와 있습니다. 최신 버전이 출시되면 가능한 한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다. 예정된 날짜는 해당 월에 언제든지 지원이 종료될 수 있으며 날짜가 변경될 수 있음을 의미합니다. API 버전 지원 종료 알림을 받으려면 블로그를 구독하세요.

API 버전	출시일	지원 중단일	지원 소멸일	업그레이드 가이드
v21	2025년 8월 6일			v20에서 v21로 업그레이드
v20.1	2025년 8월 6일		2026년 6월 (예정)	v19에서 v20으로 업그레이드
v20	2025년 6월 4일		2026년 6월 (예정)	v19에서 v20으로 업그레이드
v19.2	2025년 8월 6일		2026년 2월 (예정)	v18에서 v19로 업그레이드
v19.1	2025년 4월 16일		2026년 2월 (예정)	v18에서 v19로 업그레이드
v19	2025년 2월 26일		2026년 2월 (예정)	v18에서 v19로 업그레이드
v18	2024년 10월 16일	2025년 6월	2025년 8월 20일

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

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

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

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

용어	지원 중단	일몰
정의	지원 중단된 버전은 최신 버전이 아닌 버전입니다. 새 버전이 출시되면 이전 버전은 모두 지원 중단으로 표시됩니다.	서비스 종료된 버전은 더 이상 사용할 수 없습니다. 이 버전으로 전송된 요청은 서비스 종료일 당일 또는 이후에 실패합니다.
의미	지원 중단될 때까지 지원 중단된 버전을 계속 사용할 수 있지만 지원 중단된 버전의 참조는 더 이상 최신 버전이 아님을 나타내기 위해 강조 표시가 해제됩니다. 새로운 기능을 활용하려면 최대한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다.	Google Ads API를 사용하려면 지원이 종료된 버전에서 즉시 업그레이드해야 합니다. 업그레이드 가이드를 사용하여 최신 버전으로 업그레이드하는 것이 매우 좋습니다.
타이밍	평균적으로 3~4개월마다 새 버전이 출시되므로 지정된 버전은 약 3~4개월 후에 지원이 중단됩니다.	버전 출시 후 1년이 지나면 지원을 종료할 예정입니다.
API	지원 중단된 버전의 API 엔드포인트는 여전히 평소와 같이 작동합니다. 클라이언트 라이브러리, REST 등을 사용하여 API 엔드포인트에 액세스할 수 있지만 지원 중단된 버전에는 새 기능이 추가되지 않습니다.	지원 종료된 버전의 API 엔드포인트는 지원 종료 날짜 이후에 작동이 중지됩니다. 지원 종료된 버전의 API 엔드포인트에 액세스하려고 하면 Google Ads API에서 오류가 발생합니다.
클라이언트 라이브러리	간결한 클라이언트 라이브러리를 제공하기 위해 지원 중단 날짜가 지난 후에는 새 클라이언트 라이브러리 버전에 지원 중단된 API 버전을 포함하지 않습니다. 이렇게 하면 프로젝트에 클라이언트 라이브러리를 통합할 때 공간을 절약할 수 있습니다. 핵심사항: 지원 중단된 API 버전은 이전에 출시된 클라이언트 라이브러리 버전에서 계속 사용할 수 있습니다. API 버전이 지원 중단될 때까지는 계속 다운로드하여 사용할 수 있습니다.	클라이언트 라이브러리는 서비스 종료일이 지난 후의 새 클라이언트 라이브러리 버전에서 서비스 종료된 API 버전을 더 이상 지원하지 않습니다.
지원	지원 중단된 버전에 대한 정기 지원이 제공됩니다.	서비스 종료된 버전은 서비스 종료일이 지나면 더 이상 지원되지 않습니다.

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

표에는 어떤 클라이언트 라이브러리가 어떤 API 버전과 호환되는지 나와 있습니다.

자바

Google Ads API	자바용 클라이언트 라이브러리
v21	Min: 39.0.0 Max: -
v20	Min: 38.0.0 Max: -
v19	Min: 36.0.0 Max: -

C#

Google Ads API	.NET용 클라이언트 라이브러리
v21	Min: 24.0.0 Max: -
v20	Min: 23.0.0 Max: -
v19	Min: 22.1.0 Max: -
v18	Min: 21.1.0 Max: 23.0.0

PHP

Google Ads API	PHP용 클라이언트 라이브러리
v21	Min: 31.0.0 Max: -
v20	Min: 28.0.0 Max: -
v19	Min: 26.1.0 Max: -
v18	Min: 25.0.0 Max: 30.0.0

Python

Google Ads API	Python용 클라이언트 라이브러리
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 25.2.0 Max: -

Ruby

Google Ads API	Ruby용 클라이언트 라이브러리
v21	Min: 35.0.0 Max: -
v20	Min: 34.0.0 Max: -
v19	Min: 32.0.0 Max: -
v18	Min: 31.0.0 Max: -

Perl

Google Ads API	Perl용 클라이언트 라이브러리
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -
v19	Min: 26.0.0 Max: -
v18	Min: 25.0.1 Max: 28.0.0

기능 지원 중단

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

다음 표에는 Google Ads API에서 계획된 구체적인 기능 지원 중단이 나와 있습니다. 각 지원 중단에 대한 자세한 내용은 연결된 블로그 게시물을 참고하세요.

기능	설명	시행일	기타 참고사항
앱 캠페인 실적에 영향을 미치는 전환 환경	2025년 9월 30일부터 입찰 모델이 점진적으로 변경되어 가져온 전환에 포함된 전환 환경 데이터를 사용하여 캠페인 실적을 최적화할 수 있게 됩니다.	2025년 10월 3일	자세한 내용은 블로그 게시물을 참고하세요.
전환에는 `gclid` 값과 `gbraid` 값이 모두 포함될 수 있습니다.	2025년 10월 3일부터 `gclid` 및 `gbraid` 필드가 모두 설정된 경우 가져온 전환에서 더 이상 `VALUE_MUST_BE_UNSET` 오류가 반환되지 않습니다.	2025년 10월 3일	자세한 내용은 블로그 게시물을 참고하세요.