Hướng dẫn này giải thích cách bắt đầu viết ứng dụng sử dụng API Ads Data Hub REST để tương tác với Ads Data Hub. API REST trung tâm dữ liệu quảng cáo cho phép bạn xem những khách hàng trong 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 vài bước trước khi sử dụng Ads Data Hub API:
- Đả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 Ads Data Hub API trong dự án Google Cloud mà bạn tạo thông tin đăng nhập ứng dụng hoặc tài khoản dịch vụ. 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 ENABLE (BẬT).
- Quản lý quyền:
- Bạn phải thêm địa chỉ email hoặc tài khoản dịch vụ được 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 các truy vấn trong Ads Data Hub.
- (Nên dùng) Cài đặt thư viện ứng dụng Google API:
- Thư viện ứng dụng API của Google được cung cấp 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ù điều này là không bắt buộc, nhưng các thư viện ứng dụng sẽ giảm số lượng mã bạn phải 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 cho Python |
Xác thực và uỷ quyền
Ads Data Hub API có thể truy cập và thay đổi dữ liệu trong tài khoản khách hàng Ads Data Hub, 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 Ads Data Hub API, bạn cần thực hiện một 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ụ
- Truy cập vào bảng điều khiển API của Google rồi chuyển đến dự án quản trị.
- 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 không, hãy nhấp vào + Bật API và dịch vụ rồi bật Ads Data Hub API.
- Trong trình đơn điều hướng bên trái, hãy nhấp vào IAM và Quản trị viên > Tài khoản dịch vụ.
- 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.
- Nhấp vào trình đơn có biểu tượng 3 dấu chấm () trong phần "Thao tác", rồi 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 bạn đã chọn "JSON", hãy nhấp vào Create (Tạo).
- 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 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))
Các bước tiếp theo
- Xem truy vấn mẫu trong Ads Data Hub để 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 Ads Data Hub.
- Mở rộng các mẫu để tự 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 truy vấn cuộc 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 chỉnh.
- 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.