Google Ads API 개발자 어시스턴트

Google Ads API 개발자 어시스턴트는 Google Ads API 워크플로를 가속화하도록 설계된 Gemini CLI의 강력한 확장 프로그램입니다. 어시스턴트를 사용하면 자연어를 사용하여 Google Ads API와 상호작용할 수 있으므로 터미널 내에서 직접 질문하고, 코드를 생성하고, 데이터를 검색하고, 문제를 해결하는 것이 더 쉬워집니다.

이점

  • 생산성 향상: 문서를 검색하고 상용구 코드를 작성하는 데 드는 시간을 줄일 수 있습니다.
  • 복잡한 작업 간소화: 간단한 영어 프롬프트에서 Google Ads 쿼리 언어 (GAQL) 및 클라이언트 라이브러리 코드를 생성합니다.
  • API 학습: API 개념을 이해하고 자연어 요청이 실행 가능한 코드로 변환되는 방법을 확인합니다.
  • 대화형 디버깅: 오류를 이해하고 문제 해결에 관한 단계별 안내를 받을 수 있습니다.
  • 간소화된 워크플로: 명령줄 내에서 개발 및 테스트 루프를 유지합니다.

기본 요건

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

  1. Google Ads API 액세스:

  2. 소프트웨어:

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

  3. 저장소:

    • GitHub의 google-ads-api-developer-assistant 저장소의 로컬 클론:

시작하기

  1. 프로젝트 디렉터리로 이동합니다.

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

  2. 설정 스크립트 실행: 이 스크립트는 어시스턴트의 GEMINI.md 컨텍스트 파일과 필요한 도구를 사용하도록 Gemini CLI를 구성합니다.

    ./setup.sh

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

  3. Gemini CLI를 시작합니다.

    gemini

  4. 어시스턴트와 상호작용: 이제 자연어로 질문하거나 명령을 내릴 수 있습니다.

주요 특징

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

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

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

    • '지난 30일 동안 전환수가 가장 많은 캠페인을 보여 줘.'
    • '캠페인 ID 12345의 사용 설정된 모든 광고 그룹 이름을 가져와'
    • '모든 캠페인에서 비승인된 광고를 찾습니다.' 생성된 코드는 saved_code/ 디렉터리에 저장됩니다.

  • 직접 API 실행: 생성된 읽기 전용 Python 스크립트를 Gemini CLI에서 직접 실행하고 터미널에서 형식이 지정된 결과를 확인합니다. 어시스턴트가 코드를 생성하면 화면에 다음과 같은 메시지가 표시됩니다.

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run를 입력하면 어시스턴트 컨텍스트에서 스크립트가 실행됩니다.

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

    • '결과를 CSV 파일로 저장해 줘.' 파일은 saved_csv/ 디렉터리에 저장됩니다.

  • 문제 해결 지원: 오류 메시지 또는 예상치 못한 API 동작에 대한 도움을 받습니다.

    • 'AuthenticationError.OAUTH_TOKEN_INVALID' 오류가 발생했습니다. 어떻게 해야 하나요?
    • '질문에 대한 결과가 표시되지 않는 이유는 무엇인가요?'

사용 사례

  • 보고:
    • "고객 12345678의 지난달 비용 기준 상위 5개 키워드를 알려 줘."
  • 계정 구조:
    • '모든 캠페인 이름과 ID를 나열해 줘.'
  • 문제 해결:
    • '전환을 100개 업로드했는데 UI에는 78개만 표시됩니다. API를 사용하여 이 문제를 디버깅하려면 어떻게 해야 하나요?'
  • 학습:
    • 'API를 사용하여 실적 최대화 캠페인을 만드는 방법을 안내해 줘.'

커뮤니티 및 지원

참여 가이드라인

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