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

기본 요건

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

  1. Google Ads API 액세스:

  2. 소프트웨어:

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

  3. 저장소:

시작하기

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

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

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

    ./install.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을 입력하면 기본 언어가 Python, Ruby 또는 PHP인 경우 스크립트가 어시스턴트 컨텍스트에서 실행됩니다. 컴파일된 언어는 보안 정책으로 인해 실행되지 않습니다.

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

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

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

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

사용 사례

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

커뮤니티 및 지원

참여 가이드라인

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