Ủy quyền và tiêu đề HTTP

Video: Xác thực

Bạn cần có cả thông tin đăng nhập ứng dụng OAuth 2.0 và mã thông báo nhà phát triển khi gọi API Google Ads. Nếu đang thực hiện lệnh gọi API bằng tài khoản người quản lý Google Ads, thì bạn cũng cần chỉ định tiêu đề login-customer-id cho mỗi yêu cầu. Trang này mô tả cách đặt các 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 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à cho phép các yêu cầu API. Bạn có thể định cấu hình cả ứng dụng khách OAuth 2.0 và tài khoản dịch vụ. Để biết thêm thông tin chi tiết về cách định cấu hình tính năng uỷ quyền phía máy khách, hãy xem OAuth2 trong API Google Ads.

Nếu mới sử dụng API Google, bạn có thể sử dụng oauth2l hoặc Playground để thử nghiệm với thông tin đăng nhập ứng dụng và API Google Ads trước khi viết mã cho ứng dụng.

Sử dụng luồng ứng dụng web hoặc máy tính để bàn

Làm theo các bước để định cấu hình dự án Google API Console cho API Google Ads. Ghi lại ID ứng dụng kháchmật khẩu ứng dụng khách, sau đó quay lại trang này.

Sau khi bạn tạo một ứng dụng OAuth, hãy làm theo hướng dẫn về quy trình ứng dụng dành cho máy tính hoặc hướng dẫn về quy trình ứng dụng web để tạo mã làm mớimã 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 hướng dẫn về Tài khoản dịch vụ để thiết lập quyền truy cập vào tài khoản dịch vụ cho API Google Ads.

Sau khi bạn thiết lập tài khoản dịch vụ để truy cập vào tài khoản Google Ads của mình, hãy làm theo hướng dẫn Sử dụng OAuth 2.0 cho ứng dụng từ máy chủ đến máy chủ và nhớ chọn thẻ HTTP/REST. scope để sử dụng để truy cập vào API Google Ads là https://www.googleapis.com/auth/adwords.

Đang tạo mã truy cập mới

Sau khi có mã ứng dụng khách, mật khẩu ứng dụng kháchmã làm mới, bạn có thể tạo mã truy cập mới để sử dụng trong các lệnh gọi API bằng 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 mà 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 /v16/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ã thông báo của nhà phát triển

API Google Ads cũng yêu cầu bạn phải có một 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ý ngay từ giao diện người dùng Google Ads. Để biết thêm thông tin chi tiết về cách thiết lập bằng mã của nhà phát triển, hãy xem phần Lấy mã của nhà phát triển.

Bạn cần phải đưa giá trị của mã của nhà phát triển vào tiêu đề HTTP developer-token của mọi lệnh gọi API đến API Google Ads:

GET /v16/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Đăng nhập mã khách hàng

Đối với các lệnh gọi API Google Ads do người quản lý thực hiện đến 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 đến một trong các tài khoản khách hàng của API đó), bạn cũng cần cung cấp tiêu đề HTTP login-customer-id. Giá trị này biểu thị 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 cùng bên phải của trang. Khi chỉ định mã khách hàng, hãy nhớ xoá mọi dấu gạch nối (—), ví dụ: 1234567890 chứ không phải 123-456-7890.

GET /v16/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. Hãy xem hướng dẫn Cấu trúc lệnh gọi API để biết thêm thông tin 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 đây được trả về trong phản hồi HTTP từ API.

Mã yêu cầu

request-id là một chuỗi nhận dạng duy nhất yêu cầu API. Khi gỡ lỗi hoặc khắc phục sự cố với các lệnh gọi API cụ thể, request-id là một giá trị nhận dạng quan trọng cần có khi liên hệ với bộ phận hỗ trợ nhà phát triển của Google.

request-id: 2a5Cj89VV7CNhya1DZjjrC