Bắt đầu sử dụng API Ads Data Hub

Hướng dẫn này giải thích cách bắt đầu viết các ứng dụng sử dụng API REST của Trung tâm dữ liệu Google Ads để tương tác với Trung tâm dữ liệu Google Ads. API REST của Trung tâm dữ liệu quảng cáo cho phép bạn xem những khách hàng của Trung tâm dữ liệu quảng cáo được liên kết với tài khoản Google của bạn, tạo truy vấn và chạy truy vấn.

Thiết lập

Bạn cần hoàn tất một số bước trước khi sử dụng API Trung tâm dữ liệu quảng cáo:

  1. Đảm bảo rằng người dùng bật API được cấp quyền serviceusage.services.enable trong dự án Google Cloud. Người dùng có quyền serviceusage.services.enable cũng phải có tên trong danh sách cho phép để truy cập vào API.
  2. Bật API Trung tâm dữ liệu quảng cáo trong dự án Google Cloud nơi bạn đã tạo thông tin xác thực ứng dụng hoặc tài khoản dịch vụ. Cách bật API Trung tâm dữ liệu quảng cáo cho một dự án bằng bảng điều khiển:
    1. Chuyển đến Thư viện API Cloud Console.
    2. Chọn dự án bạn muốn sử dụng trong danh sách dự án.
    3. Tìm "Ads Data Hub API".
    4. Trên trang API, hãy nhấp vào BẬT.
  3. Quản lý quyền:
    1. Bạn phải thêm địa chỉ email hoặc tài khoản dịch vụ dùng để tạo thông tin xác thực vào Ads Data Hub với các quyền thích hợp. Đối với tài khoản dịch vụ, đây là địa chỉ email của tài khoản dịch vụ. Đối với OAuth, đây là địa chỉ email của người dùng. Điều này đảm bảo rằng tài khoản dịch vụ hoặc tài khoản của người dùng cuối có quyền chạy truy vấn trong Ads Data Hub.
  4. (Nên dùng) Cài đặt thư viện ứng dụng Google API:
    1. Thư viện ứng dụng API của Google có sẵn bằng một số ngôn ngữ phổ biến và cho phép bạn làm việc với nhiều API của Google. Mặc dù không bắt buộc, nhưng thư viện ứng dụng sẽ giúp giảm lượng mã bạn cần viết và giúp việc thiết lập quy trình xác thực trở nên đơn giản hơn.
Thư viện ứng dụng Mẫu Ads Data Hub
Thư viện ứng dụng Google API cho Java Java
Thư viện ứng dụng API của Google dành cho Python

Xác thực và uỷ quyền

API Ads Data Hub có thể truy cập và thay đổi dữ liệu trong tài khoản khách hàng Ads Data Hub của bạn, vì vậy, API này cần xác minh rằng bạn là người dùng được uỷ quyền. Do đó, trước khi bắt đầu tương tác với API của Ads Data Hub, bạn cần phải thực hiện quy trình uỷ quyền. Quy trình uỷ quyền cung cấp cho bạn các quyền cần thiết để tương tác với API. Bạn có thể xác thực bằng OAuth 2.0 hoặc tài khoản dịch vụ.

Thiết lập tài khoản dịch vụ

  1. Truy cập vào Google API Console rồi chuyển đến dự án quản trị của bạn.
  2. Xác minh rằng API Trung tâm dữ liệu quảng cáo đã được bật cho dự án của bạn trong phần API và dịch vụ.
    1. Nếu chưa bật, hãy nhấp vào + Bật API và dịch vụ rồi bật API Trung tâm dữ liệu quảng cáo.
  3. Trong trình đơn điều hướng bên trái, hãy nhấp vào IAM & Admin (Quản trị và quản lý quyền truy cập) > Service Accounts (Tài khoản dịch vụ).
    1. Nếu bạn chưa tạo tài khoản dịch vụ, hãy tạo một tài khoản.
  4. Nhấp vào trình đơn có biểu tượng 3 dấu chấm () trong phần "Thao tác", sau đó nhấp vào Quản lý khoá.
    1. Nhấp vào Thêm khoá > Tạo khoá mới
    2. Sau khi đảm bảo rằng bạn đã chọn "JSON", hãy nhấp vào Tạo.
  5. Thêm địa chỉ email tài khoản dịch vụ làm người dùng trong tài khoản Ads Data Hub.

Gửi yêu cầu mẫu

#!/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 ADH account ID.
adh_account_id = input('ADH account ID (e.g. "customers/123456789"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=adh_account_id).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

Các bước tiếp theo

  • Hãy xem truy vấn mẫu trong Trung tâm dữ liệu quảng cáo để biết ví dụ về các truy vấn mà bạn có thể tạo và chạy bằng API REST của Trung tâm dữ liệu quảng cáo.
  • Mở rộng các mẫu để làm quen với API và tuỳ chỉnh API cho trường hợp sử dụng của bạn. Sau đó, hãy thử:
    • Trạng thái hoạt động của truy vấn thăm dò ý kiến.
    • Sử dụng thư viện ứng dụng BigQuery để truy xuất kết quả truy vấn đã hoàn tất.
  • Hãy liên hệ với nhóm hỗ trợ ADH nếu bạn có câu hỏi hoặc ý kiến phản hồi về API này.
Trước
Thiết lập tài khoản của bạn
Tiếp
Sử dụng giao diện người dùng web