Hướng dẫn này giải thích cách bắt đầu viết ứng dụng có sử dụng API REST của Ads Data Hub để tương tác với Ads Data Hub. API REST của Ads Data Hub giúp bạn xem những khách hàng của Ads Data Hub đượ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 phải hoàn tất một vài bước trước khi sử dụng API Ads Data Hub:
- Đảm bảo rằng người dùng bật API đã được cấp
Quyền
serviceusage.services.enabletrong dự án trên Google Cloud. Người dùng có quyềnserviceusage.services.enablecũng phải nằm trong danh sách cho phép để truy cập vào API. - Bật API Ads Data Hub trong dự án trên Google Cloud mà trong đó thông tin đăng nhập ứng dụng hoặc tài khoản dịch vụ được tạo. Cách bật Ads Data Hub API cho một dự án bằng bảng điều khiển:
- Chuyển đến Thư viện API Cloud Console.
- Chọn dự án mà bạn muốn sử dụng trong danh sách dự án.
- Tìm "Ads Data Hub API".
- Trên trang API, hãy nhấp vào BẬT.
- Quản lý quyền:
- Địa chỉ email hoặc tài khoản dịch vụ dùng để tạo thông tin xác thực phải vào Trung tâm dữ liệu quảng cáo bằng 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ụ. Cho OAuth, đây là địa chỉ email của người dùng. Điều này đảm bảo rằng 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.
- (Nên làm) Cài đặt một thư viện ứng dụng API của Google:
- Thư viện ứng dụng API của Google có sẵn bằng một số ngôn ngữ và cho phép bạn làm việc với nhiều API của Google. Mặc dù đây không phải bắt buộc, thư viện ứng dụng sẽ giảm lượng mã mà bạn có để ghi và giúp việc 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 API của Google dành 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 của khách hàng Ads Data Hub tài khoản của bạn nên bạn cần xác minh rằng bạn là người dùng được ủy quyền. Do đó, trước khi bắt đầu tương tác với API Ads Data Hub, bạn cần đi bộ thông qua 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ụ
- Chuyển đến bảng điều khiển API của Google rồi chuyển đến dự án quản trị của bạn.
- Xác minh rằng bạn đã bật Ads Data Hub API cho dự án của mình trong phần API và
Dịch vụ.
- Nếu chưa, hãy nhấp vào + Bật API và dịch vụ rồi bật Quảng cáo API trung tâm dữ liệu.
- Trong trình đơn điều hướng bên trái, hãy nhấp vào IAM và Quản trị > Tài khoản dịch vụ.
- Nếu bạn chưa tạo tài khoản dịch vụ, tạo một tài khoản.
- Nhấp vào trình đơn có biểu tượng 3 dấu chấm () bên dưới
"Thao tác", sau đó nhấp vào Quản lý khoá.
- Nhấp vào Thêm khoá > Tạo khoá mới
- Sau khi đảm bảo rằng "JSON" được chọn, hãy nhấp vào Tạo.
- Thêm địa chỉ email tài khoản dịch vụ làm người dùng trong Ads Data Hub tài khoản.
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
- Bạn có thể xem truy vấn mẫu trong Ads Data Hub để biết các ví dụ về các truy vấn mà bạn có thể tạo và chạy bằng API REST của Ads Data Hub.
- Hãy 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 của hoạt động truy vấn cuộc thăm dò ý kiến.
- Sử dụng thư viện ứng dụng BigQuery để truy xuất các kết quả truy vấn đã hoàn tất.
- Hãy liên hệ với bộ phận hỗ trợ của ADH nếu bạn có câu hỏi hoặc ý kiến phản hồi về API này.