지원 중단 및 지원 종료

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

• Google은 한 번에 최대 5개의 메이저 버전을 제공하기 위해 노력합니다.
• 메이저 버전의 수명은 약 12개월 이며 마이너 버전은 10개월입니다.
• **연간 최대 2회** 업그레이드를 실행해야 하며 엄격한 순차적 순서로 업그레이드할 필요는 없습니다. 예를 들어 버전 (N)에서 버전 (N+2)으로 직접 업그레이드할 수 있습니다.

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

일정

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

API 버전	출시일	지원 종료일	업그레이드 가이드
출시 버전
v21	2025년 8월 6일	2026년 8월 (예상)	v20에서 v21로 업그레이드
v22	2025년 10월 15일	2026년 10월 (예상)	v21에서 v22로 업그레이드
v23	2026년 1월 28일	2027년 2월	v22에서 v23으로 업그레이드
v23.1	2026년 2월 25일	2027년 2월	v23에서 v23.1로 업그레이드
v23.2	2026년 3월 25일	2027년 2월	v23.1에서 v23.2로 업그레이드
v24	2026년 4월 22일	2027년 5월	v23.2에서 v24로 업그레이드
v24.1	2026년 5월 13일	2027년 5월	v24에서 v24.1로 업그레이드
v24.2	2026년 6월 24일	2027년 6월	v24.1에서 v24.2로 업그레이드
예정된 버전
v25	2026년 7월	2027년 8월
v25.1	2026년 8월	2027년 8월
v25.2	2026년 9월	2027년 8월
v26	2026년 10월	2027년 11월
v26.1*	2026년 11월	2027년 11월

* v26.1은 연휴 기간과 겹치므로 선택적 출시로 지정됩니다.

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

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

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

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

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

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

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

나열된 최소 클라이언트 라이브러리 버전은 주요 Google Ads API 출시 (예: v24)에 충분합니다. 마이너 출시의 필수 클라이언트 라이브러리 버전을 보려면 연결된 변경 로그를 참고하세요.

기능 지원 중단 및 변경사항

이 페이지에서는 API 버전 수준 수명 주기에 중점을 두지만 개별 기능 지원 중단 (예: 스마트 캠페인 지원 중단) 및 버전이 지정되지 않은 워크플로 변경사항 (예: 새로운 디맨드젠 캠페인 예산 요구사항)은 별도로 추적됩니다.

활성 버전 전반에서 예정된 기능 수명 주기 및 동작 변경사항을 확인하려면 기능 지원 중단 및 버전이 지정되지 않은 변경사항 가이드를 참고하세요.