Phần này dành cho những người dùng nâng cao đã quen thuộc với quy cách OAuth 2.0 và biết cách sử dụng OAuth 2.0 với các API của Google.
Phạm vi
Một mã truy cập có thể cấp nhiều mức độ truy cập vào nhiều API. Một tham số biến có tên là scope kiểm soát tập hợp các tài nguyên và thao tác mà mã truy cập cho phép. Trong yêu cầu mã truy cập, ứng dụng của bạn sẽ gửi một hoặc nhiều giá trị trong tham số scope.
Phạm vi của API Google Ads là:
https://www.googleapis.com/auth/adwords
Xem không cần mạng
Ứng dụng khách API Google Ads thường yêu cầu quyền truy cập ngoại tuyến. Ví dụ: ứng dụng của bạn có thể muốn chạy các công việc hàng loạt khi người dùng không trực tuyến duyệt xem trang web của bạn.
Để yêu cầu quyền truy cập khi không có mạng cho loại ứng dụng web, hãy nhớ đặt tham số access_type thành offline. Bạn có thể tìm thêm thông tin trong hướng dẫn về OAuth2 của Google.
Đối với loại ứng dụng dành cho máy tính, quyền truy cập khi không có mạng được bật theo mặc định. Bạn không cần phải yêu cầu quyền này một cách rõ ràng.
Tiêu đề của yêu cầu
Tiêu đề gRPC
Khi sử dụng API gRPC, hãy thêm mã truy cập vào mỗi yêu cầu. Bạn có thể liên kết một Credential với một Channel để sử dụng cho tất cả các yêu cầu trên kênh đó. Bạn cũng có thể gửi thông tin đăng nhập tuỳ chỉnh cho từng lệnh gọi. Hướng dẫn về việc uỷ quyền gRPC cung cấp thêm thông tin chi tiết về cách xử lý việc uỷ quyền.
Tiêu đề REST
Khi sử dụng REST API, hãy truyền mã truy cập thông qua tiêu đề HTTP Authorization. Sau đây là ví dụ về yêu cầu HTTP:
# Returns the resource names of customers directly accessible by the user # authenticating the call. # # Variables: # API_VERSION, # DEVELOPER_TOKEN, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # curl -f --request GET \ "https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \