Bạn cần có cả thông tin đăng nhập ứng dụng OAuth 2.0 và nhà phát triển
mã thông báo khi gọi API Google Ads. Nếu bạn đang thực hiện lệnh gọi API
với tài khoản người quản lý Google Ads, bạn cũng cần chỉ định login-customer-id
với mỗi yêu cầu. Trang này mô tả cách đặt những giá trị này và
ghi lại một số tiêu đề HTTP bổ sung dành riêng cho API được gửi và
nhận được khi sử dụng giao diện REST.
Thông tin đăng nhập OAuth 2.0
API Google Ads sử dụng thông tin đăng nhập của ứng dụng để xác định và uỷ quyền cho API yêu cầu. Cả ứng dụng OAuth 2.0 và dịch vụ tài khoản. Để biết thêm chi tiết về cách định cấu hình ủy quyền phía máy khách, hãy xem OAuth2 trong API Google Ads.
Nếu mới sử dụng API của Google, bạn có thể sử dụng oauth2l hoặc OAuth 2.0 Playground để thử nghiệm thông tin đăng nhập ứng dụng của Google Ads và API Google Ads trước khi viết mã cho .
Sử dụng luồng ứng dụng web hoặc máy tính
Làm theo các bước để định cấu hình dự án Bảng điều khiển API của Google cho API Google Ads. Ghi lại client ID và client secret, sau đó quay lại trang này.
Sau khi bạn tạo ứng dụng OAuth, hãy làm theo quy trình liên quan đến ứng dụng dành cho máy tính hướng dẫn hoặc luồng ứng dụng web hướng dẫn để tạo mã làm mới và mã truy cập.
Sử dụng tài khoản dịch vụ
Làm theo các hướng dẫn phổ biến trong phần Dịch vụ Tài khoản hướng dẫn thiết lập quyền truy cập vào tài khoản dịch vụ cho API Google Ads.
Sau khi thiết lập tài khoản dịch vụ để truy cập vào tài khoản Google Ads của bạn, hãy làm theo
Sử dụng OAuth 2.0 cho máy chủ đến máy chủ
Đơn đăng ký
hãy nhớ chọn thẻ HTTP/REST
. scope
để sử dụng cho API Google Ads
quyền truy cập là https://www.googleapis.com/auth/adwords
.
Đang tạo mã truy cập mới
Sau khi có ID ứng dụng khách, mật khẩu ứng dụng khách và mã làm mới, bạn có thể
tạo một mã truy cập mới để sử dụng trong các lệnh gọi API bằng phương thức
Công cụ dòng lệnh curl
:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token
Sau đó, bạn sử dụng mã truy cập do yêu cầu curl trả về trong
Tiêu đề HTTP Authorization
của mọi lệnh gọi API đến API Google Ads:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Tiêu đề của yêu cầu
Mã của nhà phát triển
API Google Ads cũng yêu cầu mã của nhà phát triển để thực hiện lệnh gọi đến API. Bạn có thể đăng ký mã thông báo cho tài khoản người quản lý của mình trực tiếp từ Giao diện người dùng Google Ads. Để biết thêm chi tiết về cách thiết lập bằng mã của nhà phát triển, hãy xem Lấy Mã của Nhà phát triển.
Bạn cần đưa giá trị mã của nhà phát triển vào HTTP developer-token
tiêu đề của mọi lệnh gọi API đến API Google Ads:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Mã khách hàng đăng nhập
Đối với những lệnh gọi API Google Ads do người quản lý thực hiện đến một tài khoản khách hàng (tức là khi
đăng nhập với tư cách là người quản lý để thực hiện lệnh gọi API tới một trong các tài khoản khách hàng của họ), bạn
cũng cần cung cấp tiêu đề HTTP login-customer-id
. Giá trị này đại diện cho
mã khách hàng Google Ads của người quản lý thực hiện lệnh gọi API.
Việc thêm tiêu đề này tương đương với việc chọn một tài khoản trong giao diện người dùng Google Ads
sau khi đăng nhập hoặc nhấp vào ảnh hồ sơ của bạn ở góc trên bên phải
trang. Khi chỉ định mã khách hàng, hãy nhớ xoá mọi dấu gạch nối (—),
ví dụ: 1234567890
, không phải 123-456-7890
.
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Mã khách hàng được liên kết
Tiêu đề này chỉ được nhà cung cấp phân tích ứng dụng bên thứ ba sử dụng khi tải lượt chuyển đổi lên tài khoản Google Ads được liên kết tài khoản. Xem Hướng dẫn về cấu trúc lệnh gọi API để biết thêm chi tiết.
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
Tiêu đề phản hồi
Các tiêu đề sau được trả về trong phản hồi HTTP từ API.
Mã yêu cầu
request-id
là một chuỗi xác định duy nhất yêu cầu API. Thời gian
gỡ lỗi hoặc khắc phục sự cố với lệnh gọi API cụ thể, request-id
là giá trị nhận dạng quan trọng cần có sẵn khi liên hệ với nhà phát triển của Google
của Google.
request-id: 2a5Cj89VV7CNhya1DZjjrC