Google Ads API 개발자 어시스턴트 v3.0.0 소개

2026년 6월 10일 수요일

Google Ads API 개발자 어시스턴트의 v3.0.0이 출시되었습니다. 이번 주요 버전은 어시스턴트의 진화에서 중요한 이정표가 되며, 아키텍처 현대화, 안정성 개선, 모듈식 설계에 중점을 둡니다.

이번 출시에서는 어시스턴트를 Google Antigravity 에이전트 프레임워크로 이전하고 기술 기반 아키텍처로 전환합니다. 이러한 변경사항을 통해 어시스턴트의 견고성이 향상되고 유지보수가 쉬워지며 토큰 사용량이 줄어듭니다.

v3.0.0의 새로운 기능

1. Antigravity 프레임워크 기반

Google Ads API 개발자 어시스턴트가 gemini-cli에서 Antigravity 에이전트 프레임워크(v3.0.0)로 이전되었습니다. 이 기본 프레임워크 업그레이드는 더 체계적이고 안정적인 실행 환경을 제공합니다. 이와 함께 프로젝트의 디렉터리 및 파일 구조가 Antigravity를 완전히 지원하도록 업데이트되었습니다.

gemini-cli에 대한 지원은 이 Google 블로그 공지에 설명된 대로 2026년 6월 18일에 종료됩니다.

2. 모듈식 기술 기반 아키텍처

어시스턴트의 핵심 기능이 기능으로 전환되었습니다. 이제 어시스턴트는 컨텍스트 파일의 광범위하고 구조화되지 않은 요청 사항에 의존하는 대신 필요할 때 테스트를 거친 전문 도구 디렉터리(스킬)를 동적으로 로드합니다. 이를 통해 '할루시네이션'을 대폭 줄이고 정확하고 검증된 절차를 사용하여 작업을 실행할 수 있습니다.

이 모듈식 전환의 주요 업데이트는 다음과 같습니다.

  • GAQL 검증(validate_gaql): 전용 기술로 이동했습니다. 이제 날짜 세그먼트, click_view 단일 날짜 필터, change_status 경계에 대한 향상된 정적 쿼리 검사가 포함됩니다.
  • 전환 문제 해결(troubleshoot_conversions): 이전 conversions_support_package를 대체합니다. 모든 전환 문제 해결 및 업로드 요약 스크립트와 테스트를 하나의 일관된 기술 디렉터리로 통합합니다.
  • 구조화된 명령어(explain 및 step_by_step): 설명에 일관되고 구조화된 레이아웃을 적용하기 위해 기술로 변환되었습니다.
  • 새 계정 매핑(get_cids_under_mcc): 관리자 계정(MCC)의 모든 하위 계정을 가져오는 새로운 기술입니다.
  • 새로운 객체 검사(inspect_object): Protobuf 메시지와 Enum을 즉시 동적으로 조회하는 새로운 기능으로, 어시스턴트가 항상 올바른 구조를 사용하도록 지원합니다.
  • 새로운 실적 최대화 캠페인 등록정보 필터(pmax_listing_filter): 실적 최대화 캠페인의 등록정보 그룹 웹페이지 제외 트리 수정을 표준화하는 새로운 기술입니다.

3. 일관성 및 엄격성 강화

고품질 코드 생성 및 쿼리 검증을 위해 더 엄격한 규칙과 요구사항이 도입되었습니다.

  • 명시적 API 버전 관리: 이제 get_cids_under_mcc, validate_gaql, troubleshoot_conversions와 같은 중요한 기술에 명시적 api_version 인수가 필요하므로 모호성이 사라집니다.
  • 엄격한 GAQL 규칙:
    • GAQL 쿼리에서 SQL 집계 함수(예: SUM, COUNT, AVG)는 지원되지 않으므로 사용을 방지하는 규칙이 AGENTS.md에 추가되었습니다.
    • 어시스턴트가 최신 문서를 사용하도록 현재 API 버전에 대한 Google Ads API 개발자 사이트 출시 노트를 먼저 확인하는 규칙을 추가했습니다.
    • 간소화된 구성: AGENTS.md가 간소화되어 초기 컨텍스트 윈도우가 작아졌습니다. 프로그래매틱 기술을 위해 중복 전환 문서가 삭제되었습니다.

4. 개발자 환경(DX) 개선

개발 주기를 더 빠르고 원활하게 만들기 위해 다음과 같은 몇 가지 편의성 개선사항을 적용했습니다.

  • 영구 가상 환경(.venv): 세션이 종료될 때 가상 환경이 더 이상 삭제되지 않습니다. 시작 시 어시스턴트는 시스템의 Python 버전을 확인합니다. 최신 Python 버전을 사용할 수 있는 경우에만 .venv를 다시 빌드합니다.
  • 스마트 API 버전 캐싱: 이제 어시스턴트가 현재 Google Ads API 버전을 TTL 19시간으로 캐시하여 중복 네트워크 검사를 방지함으로써 시작 시간을 줄입니다.
  • 영구 로그를 통한 디버깅 개선: 이제 로그 메시지에 날짜/시간 스탬프가 포함됩니다. 로그 파일이 .agents/ 디렉터리에 기록되며 실행할 때마다 더 이상 재설정되지 않으므로 문제 해결을 위한 기록이 보존됩니다.

업그레이드해야 하는 이유

v3.0.0으로의 업그레이드는 주로 안정성과 구조에 관한 것입니다. Antigravity 프레임워크로 전환하고 기능을 스킬로 모듈화함으로써 어시스턴트의 예측 가능성과 리소스 효율성을 높였습니다.

더 빠른 시작, 더 안정적인 GAQL 검증, 더 강력한 문제 해결 환경을 원한다면 v3.0.0으로 업그레이드하는 것이 좋습니다.

시작하기

최초 설치

  1. Antigravity CLI 설치: https://antigravity.google/의 안내를 따릅니다.
  2. 어시스턴트 클론: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. 설치 스크립트 실행:
    • Linux/macOS: ./install.sh를 실행합니다(기본값은 Python 지원, 다른 언어의 경우 --php 또는 --ruby와 같은 플래그 사용).
    • Windows: PowerShell을 열고 .\install.ps1를 실행합니다.

v2.x에서 업그레이드

  1. saved/에서 프로젝트 디렉터리 외부의 안전한 위치로 커스텀 코드나 데이터를 복사합니다.
  2. 어시스턴트의 로컬 클론을 삭제합니다.
  3. 저장소를 클론합니다.
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. 설치 스크립트(install.sh 또는 install.ps1)를 실행하여 새 Antigravity 환경을 초기화합니다.

밥 핸콕, Google Ads API팀

라벨: google-ads-api, release