Google Ads API 개발자 어시스턴트 설치 및 사용

기본 요건

시작하기 전에 다음과 같은 항목이 필요합니다.

  1. Google Ads API 액세스:

    • Google Ads API 개발자 토큰
    • 홈 디렉터리에 있는 개발자 토큰, OAuth 2.0 사용자 인증 정보, 고객 ID로 구성된 Google Ads 구성 파일 클라이언트 라이브러리 구성 가이드 를 참고하세요.
    • Google Ads API 개념 및 인증에 대한 이해

  2. 소프트웨어:

    • Python 3.10 이상. Python은 기본 언어이므로 Python이 설치되어 있고 경로에 있어야 합니다.
    • Google Antigravity 명령줄 도구가 설치되어 있습니다.
    • jq (명령줄 JSON 프로세서) 설치 스크립트는 누락된 경우 이를 설치하려고 시도합니다.

  3. 저장소:

시작하기

  1. 프로젝트 디렉터리로 이동:

    cd <full path>/google-ads-api-developer-assistant

    (참고: Antigravity 셸 통합이 사용 설정된 경우 이 디렉터리를 입력하면 어시스턴트 세션이 자동으로 초기화됩니다).

  2. 설치 스크립트 실행: 이 스크립트는 개발 환경을 초기화하고 필요한 Google Ads 클라이언트 라이브러리를 클론합니다 (Python은 기본적으로 설치됨).

    ./install.sh

    Windows를 사용하는 경우 install.ps1 PowerShell 스크립트를 실행합니다.

  3. 사용자 인증 정보 구성: google-ads.yaml (또는 언어에 상응하는 파일)이 홈 디렉터리에 있는지 확인합니다.

  4. 어시스턴트와 상호작용: 세션이 활성 상태가 되면 터미널에서 자연어를 사용하여 어시스턴트와 직접 상호작용할 수 있습니다.

주요 특징

  • 자연어 Q&A: Google Ads API 기능, 권장사항 또는 특정 리소스에 관해 질문합니다.

    • '"사용 가능한 캠페인 유형은 무엇인가요?"'
    • "GAQL에서 날짜별로 필터링하려면 어떻게 해야 하나요?"
    • '"click_view와 impression_view의 차이점을 설명해 주세요."'

  • 코드 생성: GAQL 쿼리 및 실행 가능한 Python 코드 스니펫을 생성합니다.

    • "지난 30일 동안 전환수가 가장 많은 캠페인을 보여주세요."
    • "캠페인 ID 12345의 사용 설정된 모든 광고그룹 이름을 가져오세요."
    • '"모든 캠페인에서 비승인된 광고를 찾으세요."' 생성된 코드는 ruff를 사용하여 자동으로 린트되고 saved/code/ 디렉터리에 저장됩니다.

  • 직접 API 실행: 격리된 가상 환경 (.venv) 내에서 생성된 읽기 전용 Python 스크립트를 직접 실행하고 터미널에서 형식이 지정된 결과를 표로 확인합니다.

    • 어시스턴트에게 "코드 실행" 또는 "스크립트 실행"이라고 말하기만 하면 됩니다.
    • 보안을 위해 변경 작업 (생성, 업데이트, 삭제)은 생성되지만 실행되지 않습니다.

  • CSV 내보내기: API 호출의 표 형식 결과를 CSV 파일에 저장합니다.

    • '"결과를 CSV 파일에 저장하세요."' 파일은 saved/csv/ 디렉터리에 저장됩니다.

  • 고급 진단 및 문제 해결: 오류 메시지, 예기치 않은 API 동작 또는 오프라인 전환 문제에 관한 도움을 받습니다.

    • "쿼리 결과가 표시되지 않는 이유는 무엇인가요?"
    • "고객 123-456-7890의 전환 문제를 해결해 주세요." (saved/data/에 자세한 진단 보고서를 생성합니다.)

  • 추가 컨텍스트: 컨텍스트를 위해 자체 코드베이스 또는 맞춤 라이브러리를 추가합니다.

    • update.sh 스크립트를 --context_path 옵션과 함께 사용하여 프로젝트 파일을 등록합니다. none ./update.sh --context_path /path/to/your/codebase
    • 이렇게 하면 어시스턴트가 응답을 생성하거나 선호하는 언어로 코드를 생성할 때 추론에 애플리케이션 로직을 포함할 수 있습니다.

사용 사례

  • 보고:
    • '"고객 12345678의 지난달 비용 기준 상위 5개 키워드를 가져와 주세요."'
  • 계정 구조:
    • '"모든 캠페인 이름과 ID를 나열해 주세요."'
  • 문제 해결:
    • "전환 100개를 업로드했지만 UI에 78개만 표시됩니다. API를 사용하여 이 문제를 디버그하려면 어떻게 해야 하나요?'
  • 학습:
    • "/explain 공유 집합이란 무엇인가요?"
  • 코드 생성:
    • "company name의 실적 극대화 캠페인을 만드는 코드를 작성해 주세요."

커뮤니티 및 지원

참여 가이드라인

참여를 환영합니다. 가이드라인은 GitHub 저장소의 CONTRIBUTING.md 파일을 참고하세요.

이전
Google Ads API 개발자 어시스턴트란 무엇인가요?