Ads Data Hub API 시작하기

이 가이드에서는 Ads Data Hub REST API를 사용하여 Ads Data Hub와 상호작용하는 애플리케이션을 작성하는 방법을 설명합니다. Ads Data Hub REST API를 사용하면 Google 계정과 연결된 Ads Data Hub 고객을 보고, 쿼리를 만들고, 쿼리를 실행할 수 있습니다.

설정하기

Ads Data Hub API를 사용하기 전에 다음 몇 단계를 완료해야 합니다.

  1. API를 사용 설정하는 사용자에게 Google Cloud 프로젝트의 serviceusage.services.enable 권한이 부여되었는지 확인합니다. serviceusage.services.enable 권한이 있는 사용자도 API에 액세스할 수 있도록 허용해야 합니다.
  2. 클라이언트 사용자 인증 정보 또는 서비스 계정이 생성된 Google Cloud 프로젝트에서 Ads Data Hub API를 사용 설정합니다. 콘솔을 사용하여 프로젝트에 Ads Data Hub API를 사용 설정하려면 다음 안내를 따르세요.
    1. Cloud Console API 라이브러리로 이동합니다.
    2. 프로젝트 목록에서 사용할 프로젝트를 선택합니다.
    3. 'Ads Data Hub API'를 검색합니다.
    4. API 페이지에서 사용 설정을 클릭합니다.
  3. 권한 관리:
    1. 사용자 인증 정보를 만드는 데 사용된 이메일 주소 또는 서비스 계정을 Ads Data Hub에 추가하고 적절한 권한을 부여해야 합니다. 서비스 계정의 경우 서비스 계정 이메일 주소입니다. OAuth의 경우 사용자의 이메일 주소입니다. 이렇게 하면 서비스 계정 또는 최종 사용자의 계정에 Ads Data Hub에서 쿼리를 실행할 수 있는 권한이 부여됩니다.
  4. (권장됨) Google API 클라이언트 라이브러리를 설치합니다.
    1. Google API 클라이언트 라이브러리는 많이 사용되는 여러 언어로 제공되며 이를 통해 다양한 Google API를 사용할 수 있습니다. 필수 사항은 아니지만, 클라이언트 라이브러리를 사용하면 작성해야 하는 코드의 양이 줄어들고 더 간단하게 인증을 설정할 수 있습니다.
클라이언트 라이브러리 Ads Data Hub 샘플
Java용 Google API 클라이언트 라이브러리 Java
Python용 Google API 클라이언트 라이브러리

인증 및 승인

Ads Data Hub API는 Ads Data Hub 고객 계정의 데이터에 액세스하고 데이터를 변경할 수 있으므로 승인된 사용자인지 확인해야 합니다. 따라서 Ads Data Hub API와 상호작용하기 전에 승인 흐름을 실행해야 합니다. 승인 흐름은 API와 상호작용하는 데 필요한 권한을 제공합니다. OAuth 2.0 또는 서비스 계정을 사용하여 인증할 수 있습니다.

서비스 계정 설정

  1. Google API 콘솔에서 관리자 프로젝트로 이동합니다.
  2. API 및 서비스에서 Ads Data Hub API가 프로젝트에 대해 사용 설정되어 있는지 확인합니다.
    1. 그렇지 않은 경우 + API 및 서비스 사용 설정을 클릭하여 Ads Data Hub API를 사용 설정합니다.
  3. 왼쪽 탐색 메뉴에서 IAM 및 관리자 > 서비스 계정을 클릭합니다.
    1. 아직 서비스 계정을 만들지 않은 경우 서비스 계정을 만듭니다.
  4. '작업'에서 점 3개 메뉴()를 클릭한 다음 키 관리를 클릭합니다.
    1. 키 추가 -> 새 키 만들기를 클릭합니다.
    2. 'JSON'이 선택되었는지 확인한 후 만들기를 클릭합니다.
  5. Ads Data Hub 계정에서 서비스 계정 이메일 주소를 사용자로 추가합니다.

샘플 요청 보내기

#!/usr/bin/env python3

"""This sample shows how to retrieve all accounts associated with the user.
"""
import json
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
DISCOVERY_URL = 'https://adsdatahub.googleapis.com/$discovery/rest?version=v1'
creds = Credentials.from_service_account_file(
    'service-account.json').with_scopes(SCOPES)
developer_key = 'YOUR_DEVELOPER_KEY'  # Replace with your developer key.
service = build('AdsDataHub', 'v1', credentials=creds,
                developerKey=developer_key, discoveryServiceUrl=DISCOVERY_URL)

# Replace with your customer ID.
customer_name = input('Customer name (e.g. "customers/123"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=customer_name).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

다음 단계

  • Ads Data Hub REST API를 사용하여 만들고 실행할 수 있는 쿼리의 예는 Ads Data Hub의 샘플 쿼리를 참고하세요.
  • 샘플을 확장하여 API를 숙지하고 사용 사례에 맞게 맞춤설정합니다. 그런 후 다음을 실행합니다.
  • API에 대해 질문이나 의견이 있는 경우 ADH 지원팀에 문의합니다.
이전
계정 설정
다음
웹 UI 사용