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

기본 요건

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

  1. Google Ads API 액세스:

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

  2. 소프트웨어:

    • Python 3.10 이상. 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 실행: gemini-cli에서 생성된 읽기 전용 Python 스크립트를 직접 실행하고 터미널에서 형식이 지정된 결과를 확인합니다. 어시스턴트가 코드를 생성하면 화면에 프롬프트가 표시됩니다.

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' 오류가 발생했습니다. 어떻게 해야 하나요?
    • "쿼리 결과가 표시되지 않는 이유는 무엇인가요?"

  • 추가 컨텍스트: 컨텍스트에 코드베이스를 추가합니다.

    • v2.3.0부터 context_dir 플래그를 사용하여 프로젝트 파일을 포함합니다. ./update.sh --context_dir /path/to/your/codebase 이렇게 하면 어시스턴트가 응답을 생성할 때 추론에 애플리케이션 로직을 포함할 수 있습니다.
    • 이 기능을 사용하면 어시스턴트가 선택한 언어로 저장된 코드 예시를 생성하여 공식 클라이언트 라이브러리를 사용할 수 없는 경우에도 지원을 제공할 수 있습니다.
    • 코드 출력을 요청하기 전에 어시스턴트에게 다음을 알려주세요. write saved code examples in <language of your application>

사용 사례

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

커뮤니티 및 지원

참여 가이드라인

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

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