새 버전이 출시되면 지원 중단된 버전의 지원 종료 날짜가 정해지며, 그 이후에는 더 이상 사용할 수 없게 됩니다. 다음은 기타 유의해야 할 사항입니다.
- Google은 한 번에 최대 3개의 메이저 버전을 제공하기 위해 노력하고 있습니다.
- 주 버전의 수명은 약 12개월이며 부 버전의 수명은 10개월입니다.
- 연간 최대 2회 업그레이드를 수행해야 하며 엄격한 순서로 업그레이드하지 않아도 됩니다. 예를 들어 버전 (N)에서 버전 (N+2)로 직접 업그레이드할 수 있습니다.
- 모든 클라이언트 라이브러리가 최신 버전으로 출시되는 날짜와 지원이 종료되는 버전 간의 중복 기간은 최소 20주입니다.
Google의 클라이언트 라이브러리는 서비스의 사용 가능한 모든 버전을 지원하므로 사용된 서비스의 다른 버전을 지정하여 점진적으로 업그레이드할 수 있습니다.
일정
다음 표에는 사용 가능한 각 버전의 구체적인 지원 중단일 및 서비스 종료일과 향후 버전의 예상 출시일이 나와 있습니다. 최신 버전이 출시되면 가능한 한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다.
| API 버전 | 출시일 | 지원 중단일 | 지원 소멸일 | 업그레이드 가이드 |
|---|---|---|---|---|
| v20 | 2025년 6월 4일 | 2026년 6월 (예정) | v19에서 v20으로 업그레이드 | |
| v19.1 | 2025년 4월 16일 | 2026년 2월 (예정) | ||
| v19 | 2025년 2월 26일 | 2026년 2월 (예정) | v18에서 v19로 업그레이드 | |
| v18 | 2024년 10월 16일 | 2025년 6월 | 2025년 8월 | v17에서 v18로 업그레이드 |
프로젝트에서 사용 중인 버전 보기
Google Cloud Console을 사용하여 프로젝트에서 최근에 호출한 메서드 및 서비스 목록을 볼 수 있습니다.
- Google Cloud 콘솔에서 API 및 서비스를 엽니다.
- 표에서 Google Ads API를 클릭합니다.
- 측정항목 하위 탭에서 각 그래프에 최근 요청이 표시됩니다. 메서드 표에서 요청을 보낸 메서드를 확인할 수 있습니다. 메서드 이름에는 Google Ads API 버전, 서비스, 메서드 이름이 포함됩니다(예:
google.ads.googleads.v20.services.GoogleAdsService.Mutate). - (선택사항) 요청에 대해 보려는 기간을 선택합니다.
지원 중단과 지원 종료의 차이점
| 용어 | 지원 중단 | 일몰 |
|---|---|---|
| 정의 | 지원 중단된 버전은 최신 버전이 아닌 버전입니다. 새 버전이 출시되면 이전 버전은 모두 지원 중단으로 표시됩니다. | 서비스 종료된 버전은 더 이상 사용할 수 없습니다. 이 버전으로 전송된 요청은 서비스 종료일 당일 또는 이후에 실패합니다. |
| 의미 | 지원 중단될 때까지 지원 중단된 버전을 계속 사용할 수 있지만 지원 중단된 버전의 참조는 더 이상 최신 버전이 아님을 나타내기 위해 강조 표시가 해제됩니다.
새로운 기능을 활용하려면 최대한 빨리 최신 버전으로 업그레이드하는 것이 좋습니다. |
Google Ads API를 사용하려면 지원이 종료된 버전에서 즉시 업그레이드해야 합니다.
업그레이드 가이드를 사용하여 최신 버전으로 업그레이드하는 것이 매우 좋습니다. |
| 타이밍 | 평균적으로 3~4개월마다 새 버전이 출시되므로 지정된 버전은 약 3~4개월 후에 지원이 중단됩니다. | 버전 출시 후 1년이 지나면 지원을 종료할 예정입니다. |
| API | 지원 중단된 버전의 API 엔드포인트는 여전히 평소와 같이 작동합니다.
클라이언트 라이브러리, REST 등을 사용하여 API 엔드포인트에 액세스할 수 있지만 지원 중단된 버전에는 새 기능이 추가되지 않습니다. |
지원 종료된 버전의 API 엔드포인트는 지원 종료 날짜 이후에 작동이 중지됩니다. 지원 중단된 버전의 API 엔드포인트에 액세스하려고 하면 Google Ads API에서 오류가 발생합니다. |
| 클라이언트 라이브러리 | 간결한 클라이언트 라이브러리를 제공하기 위해 지원 중단 날짜가 지난 후에는 새 클라이언트 라이브러리 버전에 지원 중단된 API 버전을 포함하지 않습니다. 이렇게 하면 프로젝트에 클라이언트 라이브러리를 통합할 때 공간을 절약할 수 있습니다. | 클라이언트 라이브러리는 서비스 종료일이 지난 후의 새 클라이언트 라이브러리 버전에서 서비스 종료된 API 버전을 더 이상 지원하지 않습니다. |
| 지원 | 지원 중단된 버전에 대한 정기 지원이 제공됩니다. | 서비스 종료된 버전은 서비스 종료일이 지나면 더 이상 지원되지 않습니다. |
지원되는 클라이언트 라이브러리 버전
표에는 어떤 클라이언트 라이브러리가 어떤 API 버전과 호환되는지 나와 있습니다.
자바
Google Ads API |
자바용 클라이언트 라이브러리 |
v20 |
Min: 38.0.0Max: - |
v19 |
Min: 36.0.0Max: - |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 31.0.0Max: 36.1.0 |
C#
Google Ads API |
.NET용 클라이언트 라이브러리 |
v20 |
Min: 23.0.0Max: - |
v19 |
Min: 22.1.0Max: - |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: 22.2.0 |
PHP
Google Ads API |
PHP용 클라이언트 라이브러리 |
v20 |
Min: 28.0.0Max: - |
v19 |
Min: 26.1.0Max: - |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: 27.2.0
|
Python
Google Ads API |
Python용 클라이언트 라이브러리 |
v20 |
Min: 27.0.0Max: - |
v19 |
Min: 25.2.0Max: - |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: 26.1.0 |
Ruby
Google Ads API |
Ruby용 클라이언트 라이브러리 |
v20 |
Min: 34.0.0Max: - |
v19 |
Min: 32.0.0Max: - |
v18 |
Min: 31.0.0Max: - |
Perl
Google Ads API |
Perl용 클라이언트 라이브러리 |
v20 |
Min: 27.0.0Max: - |
v19 |
Min: 26.0.0Max: - |
v18 |
Min: 25.0.1Max: - |
기능 지원 중단
Google Ads 개발자 블로그를 정기적으로 모니터링하여 예정된 기능 지원 중단에 대한 소식을 가장 먼저 받아보세요.
다음 표에는 Google Ads API에서 계획된 구체적인 기능 지원 중단이 나와 있습니다. 각 지원 중단에 대한 자세한 내용은 연결된 블로그 게시물을 참고하세요.
| 기능 | 설명 | 시행일 | 기타 참고사항 |
|---|---|---|---|
| 잘못된 개발자 토큰에 대한 새로운 오류 메시지 | 2025년 4월 28일부터 잘못된 개발자 토큰은 v19.1 이상의 경우 DEVELOPER_TOKEN_INVALID를, v19.1 이전 버전의 경우 DEVELOPER_TOKEN_NOT_APPROVED를 반환합니다. 이전에 반환된 잘못된 개발자 토큰은 OAUTH_TOKEN_HEADER_INVALID이며, 잘못된 OAuth 헤더에 계속 사용됩니다. |
2025년 4월 28일 | 이 변경사항은 이미 작동하는 API 호출이 있는 사용자에게는 영향을 미치지 않습니다. |