Uỷ quyền cho yêu cầu
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khi ứng dụng của bạn yêu cầu dữ liệu riêng tư, yêu cầu đó phải được một ứng dụng/dịch vụ đã xác thực cho phép
người dùng nào có quyền truy cập vào dữ liệu đó.
Mọi yêu cầu mà ứng dụng của bạn gửi tới API Trình quản lý giá thầu đều phải bao gồm mã thông báo uỷ quyền. Mã thông báo
cũng xác định ứng dụng của bạn cho Google.
Giới thiệu về giao thức cấp phép
Ứng dụng của bạn phải dùng OAuth 2.0 để cho phép các yêu cầu.
Chúng tôi không hỗ trợ giao thức cấp phép nào khác. Nếu ứng dụng của bạn sử dụng tính năng Đăng nhập bằng Google, thì hệ thống sẽ xử lý một số bước trong quá trình cấp phép đối với
bạn.
Cấp phép cho các yêu cầu bằng OAuth 2.0
Tất cả các yêu cầu đối với API Trình quản lý giá thầu phải được người dùng đã xác thực uỷ quyền.
Thông tin chi tiết về quy trình uỷ quyền, hoặc "quy trình" cho OAuth 2.0 có thể khác nhau đôi chút tùy thuộc
về loại ứng dụng mà bạn đang viết. Quy trình chung sau đây áp dụng cho tất cả các loại ứng dụng:
- Khi tạo ứng dụng, bạn sẽ đăng ký ứng dụng bằng Google API Console. Sau đó, Google sẽ cung cấp thông tin bạn cần
sau này, chẳng hạn như ID ứng dụng khách và mật khẩu ứng dụng khách.
- Gửi quy trình xác minh bằng OAuth
xem lại yêu cầu cho ứng dụng của bạn để truy cập vào phạm vi API Trình quản lý giá thầu.
- Kích hoạt Bid Manager API (API Trình quản lý giá thầu) trong Google API Console. (Nếu API không được liệt kê trong
Bảng điều khiển API, sau đó bỏ qua bước này.)
- Khi cần quyền truy cập vào dữ liệu người dùng, ứng dụng của bạn sẽ yêu cầu Google cung cấp phạm vi cụ thể
truy cập.
- Google sẽ hiển thị màn hình yêu cầu sự đồng ý cho người dùng để yêu cầu họ cấp quyền cho ứng dụng của bạn
truy cập vào một số dữ liệu của họ.
- Nếu người dùng đồng ý, thì Google sẽ cấp cho ứng dụng của bạn một mã truy cập ngắn hạn.
- Ứng dụng yêu cầu dữ liệu người dùng và đính kèm mã truy cập vào yêu cầu.
- Nếu xác định rằng yêu cầu của bạn và mã này là hợp lệ, Google sẽ trả về dữ liệu mà ứng dụng yêu cầu.
Một số quy trình có các bước bổ sung khác, chẳng hạn như sử dụng mã làm mới để lấy quyền truy cập mới
mã thông báo. Để biết thông tin chi tiết về quy trình cho nhiều loại ứng dụng, hãy xem tài liệu về OAuth 2.0 của Google.
Phạm vi của OAuth
Dưới đây là thông tin về phạm vi OAuth 2.0 cho API Trình quản lý giá thầu:
| Phạm vi |
Ý nghĩa |
https://www.googleapis.com/auth/doubleclickbidmanager |
Quyền đọc/ghi |
Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cần có thông tin về phạm vi truy cập cũng như
thông tin mà Google cung cấp khi bạn đăng ký ứng dụng (chẳng hạn như mã ứng dụng khách và
mật khẩu ứng dụng khách).
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eApplications need authorization from an authenticated user to access private data through the Bid Manager API.\u003c/p\u003e\n"],["\u003cp\u003eThe Bid Manager API exclusively supports OAuth 2.0 for authorization and requires apps to pass an OAuth verification review.\u003c/p\u003e\n"],["\u003cp\u003eApps must be registered using the Google API Console, undergo an OAuth verification review, and request specific scopes for data access.\u003c/p\u003e\n"],["\u003cp\u003eUpon user consent, Google provides a short-lived access token which the app uses to make authorized requests for user data.\u003c/p\u003e\n"]]],["Apps requesting private data through the Bid Manager API must be authorized by an authenticated user via OAuth 2.0. The process involves registering the app with Google, submitting an OAuth verification request, and activating the API. The app then requests a specific access scope, prompting a user consent screen. Upon approval, Google issues a short-lived access token. This token is included in data requests, allowing Google to validate the request and return data. The available scope is for read/write access.\n"],null,["# Authorize Requests\n\nWhen your app requests private data, the request must be authorized by an authenticated\nuser who has access to that data.\n| **Note:** If your app accesses the Bid Manager API, it must pass the [OAuth verification review](//support.google.com/cloud/answer/7454865#verification). If you see **unverified app** on the screen when testing your app, you must submit a verification request to remove it. Learn more about [unverified apps](//support.google.com/cloud/answer/7454865) or get answers to [frequently asked questions about app\n| verification](//support.google.com/cloud/answer/9110914).\n\nEvery request your app sends to the Bid Manager API must include an authorization token. The token\nalso identifies your app to Google.\n\nAbout authorization protocols\n-----------------------------\n\nYour app must use [OAuth 2.0](/identity/protocols/OAuth2) to authorize requests.\nNo other authorization protocols are supported. If your app uses [Google Sign-In](/identity#google-sign-in), some aspects of authorization are handled for\nyou.\n\nAuthorizing requests with OAuth 2.0\n-----------------------------------\n\nAll requests to the Bid Manager API must be authorized by an authenticated user.\n\nThe details of the authorization process, or \"flow,\" for OAuth 2.0 vary somewhat depending\non what kind of app you're writing. The following general process applies to all app types:\n\n1. When you create your app, you register it using the [Google API Console](https://console.cloud.google.com/). Google then provides information you'll need later, such as a client ID and a client secret.\n2. Submit an [OAuth verification\n review](//support.google.com/cloud/answer/7454865#verification) request for your app in order to access the Bid Manager API scope.\n3. Activate the Bid Manager API in the Google API Console. (If the API isn't listed in the API Console, then skip this step.)\n4. When your app needs access to user data, it asks Google for a particular **scope** of access.\n5. Google displays a **consent screen** to the user, asking them to authorize your app for access to some of their data.\n6. If the user approves, then Google gives your app a short-lived **access token**.\n7. Your app requests user data, attaching the access token to the request.\n8. If Google determines that your request and the token are valid, it returns the requested data.\n\nSome flows include additional steps, such as using **refresh tokens** to acquire new access\ntokens. For detailed information about flows for various types of apps, see Google's [OAuth 2.0 documentation](/identity/protocols/OAuth2).\n\nOAuth scope\n-----------\n\nHere's the OAuth 2.0 scope information for the Bid Manager API:\n\n| Scope | Meaning |\n|---------------------------------------------------------|--------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` | Read/write access. |\n\nTo request access using OAuth 2.0, your app needs the scope information, as well as\ninformation that Google supplies when you register your app (such as the client ID and the\nclient secret)."]]
