Google Ads API 연결 설정 방법

Google Ads API 연결 및 설정 방법

Google Ads API를 사용하기 위해 **Google Ads 계정 연결**하는 방법을 단계별로 안내드리겠습니다. 이 과정을 통해 Google Ads API를 통해 광고 데이터를 조회하거나 수정할 수 있습니다.

1. Google Ads 계정 만들기

Google Ads 계정이 없다면 [Google Ads](https://ads.google.com/)에 방문하여 계정을 생성합니다. 계정을 만들고 광고 캠페인을 설정할 수 있습니다.

2. Google Cloud 프로젝트 생성

2.1 Google Cloud Console에 로그인

[Google Cloud Console](https://console.cloud.google.com/)에 로그인합니다.

2.2 프로젝트 만들기

왼쪽 상단의 **프로젝트 선택** 버튼을 클릭하고 **새 프로젝트**를 선택하여 새로운 프로젝트를 만듭니다.
프로젝트 이름과 결제 계정을 설정합니다.

3. Google Ads API 활성화

Google Cloud Console에서 **API 및 서비스** > **라이브러리**로 이동합니다.

"Google Ads API"를 검색하여 해당 API를 활성화합니다.

4. OAuth 2.0 클라이언트 ID 생성

4.1 OAuth 2.0 인증 설정

**API 및 서비스** > **사용자 인증 정보**로 이동합니다.
**사용자 인증 정보 만들기** > **OAuth 클라이언트 ID**를 선택합니다.
애플리케이션 유형은 **웹 애플리케이션**을 선택합니다.

4.2 리디렉션 URI 설정

리디렉션 URI를 설정합니다. 예를 들어, 로컬 개발 환경에서 `http://localhost:8080`을 사용할 수 있습니다. 실제로 사용할 웹사이트 URI로 설정하세요.

4.3 클라이언트 ID와 클라이언트 비밀 키

생성 후 **클라이언트 ID**와 **클라이언트 비밀 키**를 다운로드하여 안전한 곳에 저장합니다. 이 정보는 OAuth 인증 과정에서 필요합니다.

5. Google Ads API 액세스 권한 요청

5.1 Google Ads 계정에 연결

[Google Ads API](https://ads.google.com/intl/ko_kr/home/tools/ads-api/) 페이지로 이동하여 **API 액세스 신청**을 합니다. 신청 후, Google Ads 계정과 연결할 수 있는 권한을 요청합니다.

5.2 계정 연결

**Google Ads** 계정에서 **API 액세스**를 활성화합니다.
**Google Ads 관리자 계정**에 로그인하고 **Tools & Settings** > **Access and security** > **API Center**로 이동하여 **Google Ads API 액세스**를 설정합니다.
이 과정에서 클라이언트 ID를 추가하고, 권한을 부여합니다.

6. OAuth 2.0 인증을 통한 액세스 토큰 얻기

6.1 OAuth 인증 플로우 구현

클라이언트 ID와 클라이언트 비밀 키를 사용하여 **OAuth 2.0 인증**을 구현합니다. 인증 과정에서 사용자에게 액세스 권한을 요청하고 승인을 받으면 **액세스 토큰**과 **갱신 토큰**을 받습니다.

6.2 액세스 토큰 사용

액세스 토큰을 사용하여 Google Ads API에 요청을 보낼 수 있습니다. 액세스 토큰은 일정 시간이 지나면 만료되므로, 갱신 토큰을 사용하여 자동으로 갱신합니다.

7. Google Ads API 사용

7.1 Google Ads API 라이브러리 설치

Python, Java, PHP 등의 Google Ads API 라이브러리를 설치합니다. 예를 들어, Python에서는 `google-ads` 라이브러리를 설치합니다:

pip install google-ads

7.2 API 호출

Google Ads API를 호출하여 캠페인, 광고 그룹, 키워드 등의 데이터를 가져올 수 있습니다. API를 통해 키워드 순위, 클릭수, 노출수 등의 데이터를 분석할 수 있습니다.

8. API 호출 예시 (Python)


from google.ads.google_ads.client import GoogleAdsClient

# Google Ads API 클라이언트 로드
client = GoogleAdsClient.load_from_storage("google-ads.yaml")

# Google Ads 서비스 객체 생성
ga_service = client.get_service("GoogleAdsService")

# 고객 ID 설정
customer_id = 'YOUR_CUSTOMER_ID'

# 예시 쿼리: 캠페인 목록 조회
query = """
    SELECT campaign.id, campaign.name
    FROM campaign
    ORDER BY campaign.id
"""

# 쿼리 실행
response = ga_service.search(customer_id=customer_id, query=query)

# 응답 출력
for row in response:
    print(f"Campaign ID: {row.campaign.id}, Campaign Name: {row.campaign.name}")

  
    from google.ads.google_ads.client import GoogleAdsClient

# 클라이언트 초기화
client = GoogleAdsClient.load_from_storage("google-ads.yaml")

# 고객 ID
customer_id = "INSERT_CUSTOMER_ID"

# 쿼리 실행
ga_service = client.get_service("GoogleAdsService")
query = """
    SELECT
        campaign.id,
        ad_group.id,
        metrics.impressions,
        metrics.average_cpc
    FROM
        ad_group
    WHERE
        campaign.status = 'ENABLED'
"""
response = ga_service.search(customer_id=customer_id, query=query)

# 결과 출력
for row in response:
    print(f"Campaign ID: {row.campaign.id}, Ad Group ID: {row.ad_group.id}, "
          f"Impressions: {row.metrics.impressions}, Average CPC: {row.metrics.average_cpc}")

9. API 호출을 위한 인증 설정

`google-ads.yaml` 파일에 인증 정보를 설정해야 합니다. 예시는 다음과 같습니다:


client_id: "YOUR_CLIENT_ID"
client_secret: "YOUR_CLIENT_SECRET"
developer_token: "YOUR_DEVELOPER_TOKEN"
refresh_token: "YOUR_REFRESH_TOKEN"

10. 주요 오류 및 문제 해결

API 호출 제한: Google Ads API는 일정량의 호출 제한이 있으므로, 호출량을 관리해야 합니다.
인증 오류: 액세스 토큰 만료 시 갱신 토큰을 사용하여 새 토큰을 얻어야 합니다.

이 과정은 Google Ads API를 사용하여 광고 데이터를 다루는 데 필요한 기본적인 설정입니다. 각 단계에서 필요한 정보를 설정한 후 API를 통해 Google Ads 데이터를 조회하고 관리할 수 있습니다.

Google Ads API를 사용하기 위한 방법