구글 애즈 API v26 출시: 바뀐 점과 지금 할 일

구글 애즈 API v26 출시, 누가 무엇을 다시 확인하나

구글 애즈 API v26은 2026년 10월 14일 출시된 새 버전으로, 제거된 필드가 있어 v25 코드에 버전 번호만 바꾸면 오류가 날 수 있다. 구글은 v26 릴리스 노트에 바뀐 필드를 모두 적어 두었다. 이 API는 프로그램이 구글 애즈 계정을 직접 읽고 바꾸게 해 주는 연결 통로여서, 자체 코드나 자동화 도구로 계정을 다루는 팀은 쓰는 버전과 바뀐 필드부터 확인해야 한다. 아파트 관리실이 열쇠 규격을 바꿔도 현관 열쇠만 새로 깎으면 되는 집이 있고, 같은 열쇠를 쓰던 창고 자물쇠까지 갈아야 하는 집이 있는 것과 비슷하다. 구글 애즈 API도 새 버전이 나왔다고 쓰던 버전이 곧바로 끊기지는 않으므로, 먼저 내 코드가 어느 쪽인지 가려내면 된다.

구글 애즈 API v26 변경 내용

구글 애즈 API 릴리스 노트에 따르면 v26에는 기존 코드를 깨뜨릴 수 있는 변경(breaking change)과 새 기능이 함께 들어 있다. 아래 표는 그중 광고 운영 코드에서 자주 만나는 항목이다. 필드 이름은 릴리스 노트 표기 그대로 적었다.

구분	바뀐 내용(릴리스 노트)	해야 할 일
로컬 서비스 성과 최대화 캠페인(로컬 서비스 광고 업체용 자동화 캠페인)	캠페인을 만들 때 country_code와 listing_id가 필수가 됐다	생성 코드에 두 값을 넣는다
향상된 전환(리드용)	ConversionTrackingSetting.enhanced_conversions_for_leads_enabled 필드가 제거됐다	Customer.conversion_tracking_setting의 enablement_setting으로 바꾼다
호텔 입찰 조정	호텔 전용 필드가 user_set_dates, advance_booking_window, length_of_booking, start_day_of_week, start_date_range로 바뀌었고, min_nights와 max_nights는 min_days와 max_days가 됐다. 값과 기존 입찰 조정은 그대로다	호텔 입찰 조정을 다루는 코드의 필드 이름을 바꾼다
열거형·오류 이유	HotelDateSelectionType은 DateSelectionType으로, 호텔 전용 오류 이유 6개는 여행 전반용 이름으로 대체됐다	오류 이름으로 분기하는 코드가 있으면 새 이름으로 바꾼다

같은 릴리스 노트에는 호환성을 깨지 않는 추가 사항도 있다. 광고주가 체감할 만한 것은 검색 리프트(검색 광고를 본 사람의 검색이 얼마나 늘었는지 재는 측정) 지표 15개, 디맨드젠(Demand Gen) 캠페인의 통화별 최소 일일 예산 조회, 쇼핑 캠페인의 listing_type 지원이다. 유럽연합 정치 광고 선언은 유럽연합을 겨냥하지 않는 일부 캠페인에서 선택 항목이 됐으므로, 국내 광고만 하는 계정은 이 필드를 따로 채울 필요가 줄었다. 비즈니스 메시지 소재에는 LINE과 SMS 제공자가 추가됐지만 국내에서는 카카오톡이 중심이어서 당장 쓸 곳은 많지 않다.

구글 애즈 API 버전 종료 일정, 지금 올려야 하나

v26이 나왔다고 지금 쓰는 버전이 바로 끊기지는 않는다. 구글 애즈 API 종료 일정 문서에는 아래 날짜가 적혀 있고, 종료는 해당 월 안 어느 날이든 일어날 수 있으며 날짜가 바뀔 수 있다고 안내돼 있다.

API 버전	출시일	종료 예정
v23	2026년 1월 28일	2027년 2월
v24	2026년 4월 22일	2027년 5월
v25	2026년 7월 22일	2027년 8월
v26	2026년 10월 14일	2027년 11월

v22는 이미 10월 7일부터 요청이 실패하므로 v22 호출이 남아 있다면 v26까지 기다리지 말고 v22 종료 대응 순서대로 지원되는 버전으로 먼저 옮긴다. 나머지 버전은 종료까지 3개월 이상 남았다. 맥피 권장은 v26의 새 기능이 필요 없는 팀이라면 가장 이른 v23 종료(2027년 2월) 두세 달 전에 한 번에 올리는 것이다. 필드 이름 변경은 올리는 시점이 늦어도 같은 작업이어서, 기능이 필요 없는 동안 급히 옮길 이유가 적기 때문이다.

구글 애즈 API 릴리스가 한 달 두 번으로 늘어난다

구글은 10월 12일 개발자 블로그에서 v26부터 구글 애즈 API 릴리스를 한 달에 두 번으로 늘린다고 밝혔다. 큰 변경이 들어가는 메이저 릴리스는 지금처럼 1년에 네 번이고, 나머지는 새 기능만 더하는 마이너 릴리스다. 메이저 릴리스는 출시 뒤 1년간 쓸 수 있고 마이너는 부모 메이저와 함께 종료되며, 구글은 종료 일정이 그대로여서 더 자주 이전할 필요는 없다고 설명했다.

다음 메이저인 v27은 2027년 1월, v28은 4월 출시가 예정돼 있고 날짜는 모두 추정치다. 마이너 릴리스는 새 기능만 더한다고 구글이 밝혔으므로, 자체 코드는 마이너마다 따라가지 않고 메이저 기준으로 올리면 된다. 외부 도구를 쓰는 팀은 도구 제공사가 v26을 언제 지원하는지 물어보면 된다.

구글 애즈 API v26 전환 전에 확인하는 방법

v26 호환 여부는 코드에서 바뀐 필드를 쓰는지 찾고, 테스트 계정에서 호출해 보는 순서로 확인한다. 아래 순서는 위 변경 표를 기준으로 한 점검 방법이다.

1. 코드 저장소에서 enhanced_conversions_for_leads_enabled, HotelDateSelectionType, min_nights, max_nights를 검색한다(예: grep -rn "min_nights" .). 결과가 0건이면 이 변경의 영향은 없고, 한 건이라도 나오면 위 표대로 고친다.
2. 로컬 서비스 성과 최대화 캠페인을 코드로 만들고 있다면 country_code와 listing_id를 넣는지 본다. 이 캠페인을 쓰지 않는다면 건너뛴다.
3. 구글 애즈 API 업그레이드 안내에서 v25.2에서 v26으로 올리는 항목을 열어, 쓰는 서비스의 변경점과 대조한다.
4. API 버전을 v26으로 바꾼 뒤 테스트 계정에서 조회와 변경 호출을 한 번씩 실행한다. 호출 예로 SELECT campaign.id, campaign.name FROM campaign LIMIT 5 조회를 보냈을 때 캠페인 목록이 오면 조회는 통과다. 이어서 테스트 캠페인 하나의 이름을 바꾸는 변경 호출을 보내 필드 오류 없이 정상 응답이 오면 그 코드 경로는 통과로 본다. 오류가 나면 메시지에 찍힌 필드 이름이 위 표의 옛 이름과 같은지 먼저 본다.

가장 흔한 실수는 클라이언트 라이브러리와 API 버전 번호만 v26으로 바꾸고 필드 이름은 그대로 두는 것이다. 제거된 필드를 호출하면 요청이 실패하므로, 버전을 바꾸기 전에 위 1번 검색부터 한다. 외부 광고 자동화·리포팅 도구를 쓰는 경우에는 코드를 고칠 일이 없고, 도구 제공사에 v26 지원 시점을 문의하는 것으로 충분하다.

앞으로 확인할 점

마이너 릴리스가 한 달에 두 번 나오면 새 기능은 빨라지지만, 구글이 릴리스를 더하거나 빼고 메이저와 마이너를 바꿀 수 있다고 밝혔으므로 종료 월도 달라질 수 있다. 분기마다 한 번 종료 일정 문서를 열어 쓰는 버전의 종료 예정월을 확인하고, 이번 주에는 위 1번 검색으로 영향받는 코드가 있는지부터 찾아 둔다.