Google Ads API Developer Assistant v2.0 소개

2026년 2월 26일 목요일

이번 주요 업데이트를 통해 어시스턴트는 강력한 코드 생성 도구에서 Google Ads 개발자를 위한 사전 예방적 문제 해결 및 자동화 파트너로 변모했습니다. v1.6.0 출시 이후 Google은 개발자 여러분의 의견을 수렴하여 API 개발에서 가장 까다로운 부분인 진단, 일관성, 설정에 집중했습니다.

v2.0의 새로운 기능

1. 더 간편한 설치 및 유지보수

다국어 개발 환경을 설정하는 것은 번거로운 일이 아닙니다.

  • 원클릭 설정: install.sh 또는 install.ps1와 함께 새로운 --install-deps 플래그를 사용하여 pip, composer, bundler 종속 항목을 한 번에 처리합니다.
  • 통합 디렉터리 구조: 생성된 모든 코드, CSV 내보내기, 진단 보고서가 이제 단일 saved/ 디렉터리 아래에 정리되며, 각 출력 유형에 대한 하위 디렉터리가 있습니다.
  • 원커맨드 업데이트: API 및 클라이언트 라이브러리의 새 버전이 출시되면 update.sh를 실행하여 최신 버전으로 작업해야 합니다. update.sh를 사용하여 컨텍스트에 클라이언트 라이브러리를 추가할 수도 있습니다.

2. 에이전트 전환 문제 해결

오프라인 전환 추적은 Google Ads API의 가장 강력하면서도 복잡한 기능 중 하나입니다. 전환이 기여 분석되지 않은 이유를 디버깅하는 것은 시간이 많이 소요되는 수동 프로세스일 수 있습니다.

v2.0에서는 전용 전환 문제 해결 및 진단 도구가 도입되었습니다.

  • 새 스크립트: api_examples/collect_conversions_troubleshooting_data.py
  • 새 명령어: /conversions_support_data

스크립트는 전환 문제 해결을 위한 표준 보고서를 실행하고 어시스턴트가 문제를 해결할 수 있도록 컨텍스트를 제공합니다.

이 명령어는 어시스턴트가 전환 문제를 분석하고 해결을 시도한 후에 가장 유용합니다. 해결할 수 없고 지원팀에 문의해야 하는 경우 이 명령어는 고객 설정, 전환 액션, 업로드 요약을 분석하여 이미 수행된 분석을 기반으로 구조화된 진단 보고서를 생성합니다. 또한 '비정상' 상태와 높은 실패율을 자동으로 식별하여 로그를 분석하는 데 드는 시간을 절약해 줍니다. 결과를 텍스트 파일에 저장하므로 지원 요청을 제출해야 하는 경우 이 파일을 포함할 수 있습니다.

3. 최신 API(v23)용으로 빌드됨

버전 2.0은 Google Ads API v23을 완전히 지원합니다. 모든 대화형 예시가 업데이트되었으며, 어시스턴트의 내부 컨텍스트가 최신 리소스와 필드에 최적화되어 생성된 코드를 프로덕션 레디 상태로 사용할 수 있습니다.

4. 세션 후크를 사용한 원활한 자동화

워크플로를 원활하게 진행할 수 있도록 SessionStart 및 SessionEnd 후크를 추가했습니다.

  • 자동 구성: 이제 어시스턴트가 세션 시작 시 $HOME 디렉터리에서 구성 파일을 자동으로 찾을 수 있습니다. 프로젝트 디렉터리의 하위 디렉터리 구성에 복사합니다. Python은 Gemini에서 API를 쿼리하는 데 선호하는 언어입니다. 따라서 다른 언어를 사용하는 경우 구성 파일을 읽고 쿼리를 위해 구성에 임시 google-ads.yaml을 만들지만 선호하는 언어의 코드로 계속 응답합니다.
  • 자동 정리: 종료 시 임시 구성이 안전하게 완전 삭제되므로 작업공간이 깔끔하게 유지되고 사용자 인증 정보가 안전하게 보호됩니다.

5. 더 스마트한 GAQL 검증

복잡한 GAQL 쿼리를 작성하는 것이 그 어느 때보다 쉬워졌습니다. 날짜 세그먼트 및 유한 범위 요구사항의 처리 개선을 포함하여 최신 API 극단적 사례에 대한 엄격한 유효성 검사 규칙을 적용하여 GEMINI.md 및 conversions/GEMINI.md를 업데이트했습니다. 이제 어시스턴트가 쿼리를 실행하기 전에 논리 오류를 포착합니다.

6. 스킬

스킬은 미니 플러그인 또는 '동작 청사진'이라고 생각하면 됩니다. 일반적인 컨텍스트(예: GEMINI.md 파일)는 배경 정보를 제공하지만, 스킬은 이 확장 프로그램의 현재 버전을 가져오는 것과 같이 복잡하고 절차적인 작업을 수행해야 할 때만 AI의 두뇌에 '로드'됩니다. 스킬을 직접 실행하지 않습니다. Gemini가 필요하다고 판단할 때 사용합니다.

아직 실험 단계의 기능이지만 세션 초기화 및 정리를 위한 후크 사용을 보완하기 위해 이번 버전에 포함했습니다.

업그레이드해야 하는 이유

v1.6.0에서 v2.0.0으로의 도약은 단순히 새로운 기능에 관한 것이 아니라 안정성에 관한 것입니다. v2.0은 심층적인 API 지식을 자동화된 진단 도구와 통합하여 API 통합 속도를 늦추는 '시행착오' 루프를 줄입니다.

전환 업로드를 디버깅하든 복잡한 보고 파이프라인을 빌드하든 v2.0은 더 빠르고 자신 있게 작업할 수 있는 도구를 제공합니다.

시작하기

첫 설치

이전 버전에서 업그레이드

  • saved_code/ 및 saved_csv/의 커스텀 코드를 안전한 위치에 복사합니다.
  • 프로젝트 디렉터리와 모든 하위 디렉터리 및 파일을 삭제하여 Google Ads API 개발자 어시스턴트의 로컬 클론을 삭제합니다.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • 프로젝트 디렉터리에서 install.sh 또는 install.ps1를 실행하여 확장 프로그램과 클라이언트 라이브러리를 설치합니다.

Google Ads API팀 밥 핸콕

라벨: google-ads-api, release