Google Ads API v22, 10월 7일부터 요청 실패: 버전 확인과 전환 순서

Google은 2026년 9월 2일 Google Ads API(광고 계정을 프로그램으로 읽고 바꾸는 연결 통로) v22의 지원 종료를 다시 알렸다. 2026년 10월 7일부터 v22로 보낸 API 요청은 실패한다. Google Ads 광고 게재 전체가 멈춘다는 공지는 아니다. 먼저 우리 시스템이 v22를 실제로 호출하는지 확인하고, 호출한다면 종료일 전에 지원 중인 새 버전으로 전환해야 한다.

누구에게 영향이 있나

v22는 이 API의 22번째 메이저 버전(호환성을 깨는 변경이 들어간 큰 버전)이라는 뜻이다. 광고 관리자 화면에서 직접 캠페인을 운영하는 것과는 별개의 경로다.

적용 대상은 v22 API 요청을 보내는 애플리케이션이다. 캠페인 생성·변경 스크립트, 리포트 수집기, 대시보드, 전환 데이터 연동처럼 Google Ads API에 의존하는 작업을 점검하자. API를 쓰지 않는 광고 계정의 게재 중단으로 범위를 넓히면 안 된다.

Google의 공식 안내는 10월 7일 이후 모든 v22 API 요청이 실패하기 시작한다고 적었다. 종료일까지 최신 버전으로 업그레이드하라고 권한다. 새 버전의 차이는 출시 노트와 지원 종료 일정에서 확인할 수 있다.

지금 확인할 순서

점검은 호출 찾기에서 전환 후 확인까지 네 단계로 이어진다.

1. Google Cloud Console에서 APIs & Services → Google Ads API → Metrics를 연다. Methods 표의 최근 호출에는 버전·서비스·메서드가 함께 표시된다. google.ads.googleads.v22.services.GoogleAdsService.Mutate와 같은 이름이 발견되면 해당 시스템의 소유자와 배포 경로를 추적한다.
2. 서버 코드·공식 클라이언트 라이브러리·배치 작업·Cloud Run 예약 작업·서드파티 연동에서 v22를 고정한 설정을 찾는다. 콘솔의 최근 호출 기간 밖에 있는 월간 작업도 코드와 실행 기록으로 따로 점검한다.
3. 최신 지원 버전의 변경 사항을 읽고, 인증·쿼리·필드·에러 처리를 검증 환경에서 테스트한다. 리포트 값과 변경 요청 결과를 기존 버전과 비교한다.
4. 새 버전으로 전환한 뒤에는 Metrics의 v22 호출이 더 이상 들어오지 않는지 살피고 실패율·배치 완료·다운스트림 데이터 신선도를 확인한다. 종료일 전에 전환을 끝낸다.

Google Cloud Console의 메서드 표에서는 호출 이름 중간에 API 버전이 붙어 있어, v22가 남아 있는지 한눈에 가려낼 수 있다. 아래 화면은 v25 호출만 보이는 정상 상태의 예다.

확정 사실과 실무 추론

확정 사실: 공지일은 2026년 9월 2일, v22 종료일은 2026년 10월 7일이다. 이후 v22 API 요청은 실패한다. 공식 글은 Google Cloud Console에서 최근 호출 메서드와 버전을 확인하는 경로를 안내한다.

실무 추론: v22에 의존하는 자동 보고·변경 작업은 실패할 수 있다. 실제 영향은 각 조직의 호출 여부와 실패 처리에 달려 있다. 광고 게재 자체가 일괄 중단되는 것으로 해석하지 않는다. 전환 측정과 서버 연동 구조가 익숙하지 않다면 MCPY의 전환 추적 원리를 함께 참고할 수 있다.

업데이트(2026년 10월 13일): v26부터 API 릴리스 월 2회, 2026~2027 종료 일정 공개

구글은 2026년 10월 12일 Google Ads API 2026~2027 릴리스·종료 일정을 공개했다. v26부터 릴리스가 한 달에 두 번으로 늘어나 새 기능이 더 빨리 API에 들어온다. 호환성을 깨는 메이저 버전은 지금처럼 연 4회이고, 나머지는 새 기능만 더하는 마이너 릴리스다.

메이저 버전의 지원 기간은 1년이고, 마이너 릴리스는 소속된 메이저 버전과 함께 종료된다. 릴리스 횟수는 늘었지만 마이그레이션 주기는 그대로여서, 버전을 옮기는 빈도가 높아지는 것은 아니다. 구글은 릴리스 블로그와 유튜브 설명회도 분기당 2회로 바꾼다고 밝혔다.

메이저 버전	출시 예정	종료 예정
v23	출시됨	2027년 2월
v24	출시됨	2027년 5월
v25	출시됨	2027년 8월
v26	2026년 10월	2027년 11월
v27	2027년 1월	2028년 2월
v28	2027년 4월	2028년 5월
v29	2027년 7월	2028년 8월
v30	2027년 10월	2028년 11월

표의 날짜는 구글이 예상 일정으로 밝힌 값이라 바뀔 수 있다. 연말 휴가철에 걸린 v26.3은 건너뛸 수 있고, 1월에 나오는 v27은 마이너 릴리스가 적다.

독자가 할 일은 지금 쓰는 버전의 종료월을 달력에 옮기는 것이다. v23을 쓰고 있다면 2027년 2월, v24라면 5월이 가장 가깝다. 새 마이너 릴리스는 같은 메이저 안에서 기능만 늘어나므로, 필요한 기능이 있을 때 출시 노트를 보고 옮기면 된다. 종료일은 지원 종료 일정에서 갱신된 값을 확인한다.

자주 묻는 질문

v22 종료가 광고 노출 중단을 뜻하나요? 아니다. 공지는 v22 API 요청 실패를 말한다. 광고 계정의 게재 상태는 별도 문제다.

우리 조직이 영향을 받는지 어떻게 알 수 있나요? Google Cloud Console의 Google Ads API Metrics에서 최근 호출 메서드의 버전을 확인하고, 호출 기간 밖의 배치와 코드 설정도 조사한다.

10월 7일 이후에 업그레이드해도 되나요? 그때까지 v22 요청은 실패할 수 있다. 테스트·배포·관측 시간을 고려해 종료일 전에 전환하는 편이 안전하다.

재사용할 점검 카드

• Insight: 서비스 종료 공지에서는 제품 전체와 특정 API 버전의 영향 범위를 분리한다.
• Practice: 공지의 적용일을 확인한 뒤 실제 호출 메서드, 코드 설정, 배치 실행 내역을 교차 검증한다.
• Task template: 시스템명 / 담당자 / 최근 v22 호출 여부 / 대체 버전 / 검증 결과 / 배포일 / 전환 후 v22 호출 0 확인을 한 줄씩 채운다.