2026년 8월 25일 화요일
Google Ads API 개발자 어시스턴트의 주요 버전이 출시되었습니다. 이번 출시에서는 어시스턴트가 독립형 프로젝트 설정에서 특화된 Google Ads API 기능을 AI 에이전트 워크플로에 직접 제공하도록 설계된 통합 플러그인 아키텍처로 전환됩니다.
기본 개념
Google Ads API 개발자 어시스턴트는 Antigravity 및 Claude Code와 같은 AI 코딩 환경에 Google Ads 도메인에 대한 심층적인 전문 지식을 제공합니다. AI 어시스턴트에 특화된 도구와 가드레일을 제공합니다. 함수에는 다음이 포함됩니다.
- 관용적 코드 생성: Python, Java, PHP, .NET, Ruby에서 테스트를 거친 권장사항 통합 코드를 만듭니다.
- GAQL 쿼리 검증: 쿼리를 실행하기 전에 문법, 필드 호환성, 날짜 세분화, 노출수 0 규칙을 자동으로 확인합니다.
- Protobuf 스키마 검사: 활성 Google Ads API 버전에 대한 리소스 필드, 데이터 유형, enum 정의를 주문형으로 검색하여 GAQL 쿼리 필드가 유효한지 확인합니다.
- API 문제 해결: 오프라인 전환 업로드 실패를 진단하고, 관리자 계정 계층 구조를 탐색하고, 실적 최대화 캠페인 등록정보 필터를 구성합니다. "내 계정에서 문제가 있는 모든 광고를 보여주고 해결 방법을 추천해 줘"와 같은 자연어 질문을 할 수 있습니다.
- API 질문에 답변: 어시스턴트는 내장된 Google Ads API 아키텍처 규칙과 동적 로컬 Protobuf 스키마 검사를 결합하여 질문에 답변함으로써 정확한 버전의 안내와 검증된 코드 스니펫을 제공합니다. 일반적인 모델 학습에만 의존하는 것이 아니라 공식 API 정의와 클라이언트 라이브러리 소스 코드를 직접 기반으로 대답합니다. 예를 들어 "공유 라이브러리가 무엇이고 어떻게 사용하나요?"와 같은 질문을 할 수 있습니다.
- 임시 보고: 일반적인 영어로 실적 데이터를 요청하면 어시스턴트가 Google Ads 계정에 대해 필요한 GAQL 쿼리를 즉시 구성, 검증, 실행합니다. 실시간 결과를 깔끔하게 서식이 지정된 표로 채팅에 다시 스트리밍하므로 임시 보고 및 측정항목 조사를 손쉽게 수행할 수 있습니다. 결과를 저장하려면 "<디렉터리>에 결과를 CSV 파일로 저장해 줘"라고 요청하면 됩니다. 그러면 분석을 위해 스프레드시트에 로드할 수 있습니다.
Antigravity 및 Claude Code 지원
이 버전에서는 이중 플랫폼 지원이 도입되었습니다.
- Antigravity: 전역 및 작업공간 플러그인 등록을 통해 Antigravity 개발자 환경을 기본적으로 지원합니다.
- Claude Code: 커스텀 슬래시 명령어(예:
/validate-gaql,/inspect-object,/troubleshoot-conversions,/get-cids)를 포함하여 Claude Code CLI 플러그인 시스템과 완전히 통합됩니다.
Linux, macOS(bash), Windows(PowerShell)에서 통합 설치 스크립트를 사용하여 세 플랫폼 모두에서 일관된 수명 주기 관리를 제공할 수 있습니다.
성능 향상
- 토큰 소비 감소: 규칙과 스키마를 단계적으로 공개하면 특정 작업에 필요한 컨텍스트만 로드되므로 프롬프트 토큰 오버헤드가 줄어듭니다.
- 더 빠른 응답 시간: 주문형 기술 실행과 타겟팅된 명령어 라우팅을 통해 엔드 투 엔드 작업 완료 속도가 빨라집니다.
- 낮은 CPU 사용률: 간소화된 실행 파이프라인은 개발 세션 중에 백그라운드 프로세스 오버헤드를 제거합니다.
- 디스크 I/O 감소: 플러그인 트리에 있는 불필요한 파일 수를 줄이면 파일 감시자, 린터, IDE 색인 생성기가 사용되지 않는 수만 개의 protobuf/SDK 파일을 스캔하지 않습니다.
- 메모리(RAM) 사용량 감소 및 데몬 오버헤드 제로: 이제 기술과 명령어가 호출될 때만 빠른 하위 프로세스로 일시적으로 실행되므로 유휴 상태일 때 시스템 리소스 사용량이 0으로 줄어듭니다.
- 캐시된 API 버전 및 Protobuf 스키마 확인: 어시스턴트는 표준 필드, 리소스, enum을 검사할 때 반복적인 원격 메타데이터 또는 리플렉션 API 호출을 방지합니다.
- 결정론적 명령어 실행과 멀티턴 LLM 추론: LLM이 3~4회의 왕복을 통해 GAQL 문법을 추측하거나 반복적으로 디버깅하는 대신 로컬 검사기가 필드, 리소스, 노출수 0인 측정항목, 날짜 절을 한 번에 확인합니다.
최신 플러그인 아키텍처를 기반으로 빌드된 주요 버전
이 버전은 이전 버전과 호환되지 않는 메이저 버전입니다. 이전 버전은 로컬 작업공간 프로젝트 구조를 사용했습니다. 이 버전은 전역적으로 사용할 수 있도록 설치된 표준화된 플러그인 아키텍처를 기반으로 빌드됩니다.
규칙, 기술, 진단 명령어를 독립적인 플러그인 번들로 모듈화하면 개발자가 여러 환경과 프로젝트에서 어시스턴트를 설치, 업데이트, 관리할 수 있습니다.
플러그인 아키텍처에 관한 기술 세부정보는 README.md를 참고하세요.
시작하기
이 출시 버전의 아키텍처 변경사항으로 인해 설치 전에 문서를 검토하세요.
- 기본 요건 및 환경 준비에 관한 내용은 README_BEFORE_INSTALLATION.md를 참고하세요.
- README.md의 설치 안내를 따릅니다.
여러분의 의견을 기다립니다
설문조사 양식을 사용하여 의견을 공유하고, 문제를 신고하고, 기능을 제안하세요.
👉 의견 제출하기
라벨: google-ads-api, release