SA / 검색광고
구글 애즈 API v22, 10월 7일 끝난다 — 입찰 신호는 왜 끊기나?
구글 애즈 API 버전 22(v22)는 2026년 10월 7일부터 모든 요청이 실패 처리됩니다. 광고 운영 화면을 손으로 쓰는 경우는 영향이 없지만, 전환 업로드·리포팅·입찰 조정을 이 버전에 연동해 둔 자동화 도구라면 그 시점부터 데이터가 끊깁니다. 구글 애즈 개발자 블로그가 9월에 재공지한 마감일이며, 별도의 유예 기간은 없습니다.
v22는 정확히 언제, 어떻게 멈추나?
구글은 2025년 10월 애즈 API v22를 출시했고, 2026년 9월 구글 애즈 개발자 블로그에 올라온 종료 예정 안내에서 2026년 10월 7일을 정식 종료일로 다시 확인했습니다. 이 날짜부터는 v22로 보낸 모든 요청이 즉시 실패로 처리되며, 일부 기능만 단계적으로 막는 방식이 아닙니다.
정확히 뭐가 끊기나?
영향을 받는 쪽은 구글 애즈 화면을 직접 쓰는 운영자가 아니라, v22 엔드포인트를 코드에 고정해 둔 연동 도구입니다. 오프라인 전환 업로드(uploadClickConversions), 전환 조정(uploadConversionAdjustments), 캠페인·키워드 리포팅을 이 버전으로 호출하는 스크립트나 데이터 연동 플랫폼이 10월 7일부터 오류를 돌려받습니다. 실제로 깃허브에 공개된 여러 데이터 연동 오픈소스 저장소에는 v22 만료를 경고하는 이슈가 이미 자동으로 등록돼 있습니다.
입찰에는 왜 영향이 가나?
스마트 입찰은 전환 데이터를 학습 신호로 써서 다음 입찰가를 정합니다. CRM에서 확인한 상담 성사 건을 오프라인 전환으로 올리거나 이메일·전화번호 목록을 Customer Match 오디언스로 올리는 경로가 v22에 묶여 있었다면, 10월 7일부터 이 신호가 끊깁니다. 화면상 전환수가 당장 0으로 보이지 않을 수는 있지만, 입찰 알고리즘이 받는 최신 학습 데이터는 그 시점부터 멈춥니다.
지금 뭘 확인해야 하나?
- 전환 업로드·리포팅·입찰 조정에 쓰는 도구나 대행 스크립트가 어떤 API 버전을 호출하는지 벤더나 담당 개발자에게 확인합니다.
- v22로 고정돼 있다면 10월 7일 전에 현재 지원되는 버전(예: v25, 2027년 8월까지 지원)으로 올립니다. 정확한 지원 범위는 업그레이드 시점에 구글의 공식 버전 안내 페이지에서 다시 확인합니다.
- 업그레이드 후에는 구글 애즈 계정의 전환 메뉴에서 오프라인 전환·Customer Match 업로드 건수가 10월 7일 전후로 끊기지 않았는지 확인합니다.
유예 기간을 기대할 수 있나?
구글 애즈 API 공식 버전 안내 문서에 따르면, 새 버전의 클라이언트 라이브러리가 나온 뒤 이전 버전이 종료되기까지 최소 20주의 중복 기간을 둡니다. v22도 이 기간을 거쳐 마감일이 미리 공지됐던 것이므로, 종료일이 지난 뒤 추가로 봐주는 기간은 없습니다.
정리
구글 애즈 API v22는 2026년 10월 7일부터 모든 요청이 실패합니다. 영향을 받는 쪽은 수동으로 광고를 운영하는 담당자가 아니라, 전환 업로드·리포팅·입찰 조정을 v22에 연동해 둔 자동화 도구입니다. 오프라인 전환이나 Customer Match 업로드가 이 경로를 쓰고 있었다면 스마트 입찰이 받는 학습 신호가 끊길 수 있으므로, 10월 7일 전에 연동 도구의 API 버전을 먼저 확인해야 합니다.
Q & A