Authentication
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.
Tất cả các lệnh gọi API Google Ad Manager phải được cho phép thông qua OAuth2 một tiêu chuẩn mở mà
cho phép người dùng cấp quyền cho các ứng dụng của bên thứ ba, do đó
có thể thay mặt người dùng tương tác với các dịch vụ web. OAuth2 cho phép
ứng dụng khách API Ad Manager của bạn để truy cập vào tài khoản Ad Manager của người dùng
mà không phải xử lý hoặc lưu trữ tên người dùng hoặc mật khẩu của người dùng.
Tạo thông tin xác thực OAuth2
Thực hiện các bước sau để tạo thông tin xác thực OAuth2.
1. Xác định hình thức xác thực
Xem bảng bên dưới để biết loại xác thực nào thích hợp nhất
cho ứng dụng API Ad Manager của bạn:
| Chọn loại xác thực OAuth2 |
| Tài khoản dịch vụ |
Chọn cách này nếu bạn chỉ cần quyền truy cập vào dữ liệu Ad Manager của riêng mình.
Tìm hiểu thêm.
|
| Ứng dụng web |
Chọn tuỳ chọn này nếu bạn muốn xác thực là bất kỳ người dùng nào cấp quyền
quyền cho ứng dụng của bạn để truy cập vào dữ liệu Ad Manager của họ.
Tìm hiểu thêm.
|
2. Tạo thông tin đăng nhập OAuth2
Khi bạn đã xác định được hình thức xác thực của mình, hãy nhấp vào thẻ tương ứng
ở bên dưới rồi làm theo hướng dẫn để tạo thông tin xác thực OAuth2:
- Mở
Trang Thông tin đăng nhập trên Bảng điều khiển Google API.
- Trong trình đơn thả xuống của dự án, hãy chọn Create a new project (Tạo dự án mới), rồi nhập tên
cho dự án và chỉnh sửa Mã dự án được cung cấp (không bắt buộc). Nhấp chuột
Tạo.
- Trên trang Chứng chỉ, hãy chọn Tạo thông tin xác thực, sau đó
chọn Khoá tài khoản dịch vụ.
- Chọn Tài khoản dịch vụ mới rồi chọn JSON.
- Nhấp vào Tạo để tải tệp chứa khoá riêng tư xuống.
- Mở
Trang Thông tin đăng nhập trên Bảng điều khiển Google API.
- Trong trình đơn thả xuống của dự án, hãy chọn Create a new project (Tạo dự án mới), rồi nhập tên
cho dự án (và chỉnh sửa Mã dự án được cung cấp (không bắt buộc)) rồi nhấp vào
Tạo.
- Trên trang Chứng chỉ, hãy chọn Tạo thông tin xác thực, sau đó
chọn Mã ứng dụng OAuth.
- Bạn có thể được nhắc đặt tên sản phẩm trên
trang Màn hình đồng ý; nếu có, hãy nhấp vào Định cấu hình màn hình đồng ý,
cung cấp thông tin được yêu cầu và nhấp vào Lưu để quay lại
Trang thông tin xác thực.
- Chọn Web Application (Ứng dụng web) cho Application Type (Loại ứng dụng). Làm theo
để nhập nguồn gốc JavaScript, URI chuyển hướng hoặc cả hai.
- Nhấp vào Tạo.
- Trên trang xuất hiện, hãy sao chép client ID và client secret
vào bảng nhớ tạm, vì bạn sẽ cần đến chúng khi định cấu hình ứng dụng
thư viện của bạn.
Nếu là nhà phát triển bên thứ ba, bạn có thể phải yêu cầu khách hàng thực hiện việc này
bước cho bạn.
- Truy cập vào mạng Ad Manager của bạn.
- Nhấp vào tab Quản trị.
- Đảm bảo rằng bạn đã bật quyền truy cập API.
- Nhấp vào nút Thêm người dùng tài khoản dịch vụ.
- Điền vào biểu mẫu bằng email tài khoản dịch vụ. Chiến lược phát hành đĩa đơn
người dùng tài khoản dịch vụ phải được cấp quyền truy cập vào
thực thể như thể người dùng tài khoản dịch vụ đó sẽ truy cập vào các thực thể trên
giao diện người dùng.
- Nhấp vào nút Save (Lưu). Một thông báo sẽ xuất hiện, xác nhận
thêm tài khoản dịch vụ.
- Xem người dùng hiện tại của tài khoản dịch vụ bằng cách chuyển đến thẻ Người dùng, sau đó
nhấp vào bộ lọc Tài khoản dịch vụ.
- Truy cập vào mạng Ad Manager của bạn.
- Nhấp vào tab Quản trị.
- Đảm bảo rằng bạn đã bật quyền truy cập API.
Hãy làm theo hướng dẫn thích hợp bên dưới để sử dụng thông tin xác thực trong thư viện ứng dụng:
Nếu chọn không sử dụng một trong các thư viện ứng dụng của chúng tôi, bạn cần phải triển khai
tài khoản dịch vụ OAuth2 hoặc web
quy trình ứng dụng.
Hậu trường
Thư viện ứng dụng của chúng tôi tự động xử lý các chi tiết được đề cập bên dưới để
mà bạn chỉ nên tiếp tục đọc nếu quan tâm đến những điều xảy ra đằng sau.
Phần này dành cho những người dùng nâng cao đã quen thuộc
với thông số của OAuth2 và
biết cách sử dụng OAuth2 với các API của Google.
Tiêu đề HTTP trong mọi yêu cầu tới API Ad Manager phải bao gồm quyền truy cập
mã thông báo ở biểu mẫu này:
Authorization: Bearer ACCESS_TOKEN
Ví dụ:
POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>
Phạm vi
Một mã truy cập duy nhất có thể cấp quyền truy cập khác nhau cho nhiều API. Đáp
tham số biến có tên là scope kiểm soát tập hợp tài nguyên và
các thao tác mà mã truy cập cho phép. Trong quá trình yêu cầu mã truy cập,
ứng dụng gửi một hoặc nhiều giá trị trong tham số scope.
Ad Manager chỉ có một phạm vi, như dưới đây. Cần thực hiện việc uỷ quyền
ở cấp người dùng trong sản phẩm.
| Phạm vi |
Quyền |
https://www.googleapis.com/auth/dfp |
Xem và quản lý chiến dịch của bạn trên Ad Manager. |
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\u003eAll Google Ad Manager API calls require OAuth2 authorization for secure access to user data without storing sensitive login information.\u003c/p\u003e\n"],["\u003cp\u003eChoose between Service Account or Web Application authentication type based on your application's needs.\u003c/p\u003e\n"],["\u003cp\u003eGenerate OAuth2 credentials by following instructions for your chosen authentication type via the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eConfigure your Ad Manager network settings and client library according to provided guidelines for the specific authentication method and programming language.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries handle most OAuth2 complexities but you can delve into the background details concerning HTTP headers and scopes if needed.\u003c/p\u003e\n"]]],["Google Ad Manager API access requires OAuth2 authorization. First, choose between \"Service account\" for personal data or \"Web application\" for user-authorized access. Then, create OAuth2 credentials via the Google API Console, either generating a JSON key for service accounts or a client ID and secret for web applications. Next, configure the Ad Manager network to allow API access, adding the service account email if applicable. Lastly, configure and use a client library, or implement the OAuth2 flow directly, including the access token in the HTTP header.\n"],null,["# Authentication\n\nAll Google Ad Manager API calls must be authorized through [OAuth2](http://oauth.net/2/) an open standard that\nallows users to grant permissions to third-party applications, so the\napplication can interact with web services on the user's behalf. OAuth2 enables\nyour Ad Manager API client application to access a user's Ad Manager account\nwithout having to handle or store the user's username or password.\n\nGenerate OAuth2 credentials\n---------------------------\n\nPerform the following steps to generate the OAuth2 credentials.\n\n### 1. Determine your authentication type\n\nCheck the table below to see which **authentication type** is most appropriate\nfor your Ad Manager API application:\n\n| Choose your OAuth2 authentication type ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Service account** | Choose this if you only need access to your own Ad Manager data. [Learn more.](/identity/protocols/OAuth2ServiceAccount) |\n| **Web application** | Choose this if you want to authenticate as any user who grants permission to your application to access their Ad Manager data. [Learn more.](/identity/protocols/OAuth2WebServer) |\n\n### 2. Create OAuth2 credentials\n\nOnce you've determined your authentication type, click the corresponding tab\nbelow and follow the instructions to generate the OAuth2 credentials:\nService Account\n\n1. Open the [Google API Console Credentials page](https://console.cloud.google.com/apis/credentials).\n2. From the project drop-down, choose **Create a new project** , enter a name for the project, and optionally, edit the provided Project ID. Click **Create**.\n3. On the Credentials page, select **Create credentials** , then select **Service account key**.\n4. Select [New service account](//console.developers.google.com/apis/credentials/serviceaccountkey), and select **JSON**.\n5. Click **Create** to download a file containing a private key.\nWeb application\n\n1. Open the [Google API Console Credentials page](https://console.cloud.google.com/apis/credentials).\n2. From the project drop-down, choose **Create a new project** , enter a name for the project (and optionally, edit the provided Project ID), and click **Create**.\n3. On the Credentials page, select **Create credentials** , then select **OAuth client ID**.\n4. You may be prompted to set a product name on the Consent Screen page; if so, click **Configure consent screen** , supply the requested information, and click **Save** to return to the Credentials page.\n5. Select **Web Application** for the **Application Type**. Follow the instructions to enter JavaScript origins, redirect URIs, or both.\n6. Click **Create**.\n7. On the page that appears, copy the **client ID** and **client secret** to your clipboard, as you will need them when you configure your client library.\n\n### 3. Configure your Ad Manager network\n\nIf you are a third-party developer, you may need to have your client do this\nstep for you.\nService Account\n\n1. Go to your [Ad Manager network](//admanager.google.com).\n2. Click the **Admin** tab.\n3. Ensure that **API access** is enabled.\n4. Click the **Add a service account user** button.\n5. Fill in the form using the service account email. The service account user must be granted with permissions to access the entities as if that service account user would access the entities on the UI.\n6. Click on the **Save** button. A message should appear, confirming the addition of your service account.\n7. View existing service account users by going to the Users tab and then clicking the **Service Account** filter.\nWeb application\n\n1. Go to your [Ad Manager network](//admanager.google.com).\n2. Click the **Admin** tab.\n3. Ensure that **API access** is enabled.\n\n### 4. Configure and use a client library\n\nFollow the appropriate guide below to use the credentials in your client library: \n\n### Java\n\n- [Service account flow](//github.com/googleads/googleads-java-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-java-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### .NET\n\n- [Service account flow](//github.com/googleads/googleads-dotnet-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-dotnet-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### Python\n\n- [Service account flow](//github.com/googleads/googleads-python-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-python-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### PHP\n\n- [Service account flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-(server-to-server-flow))\n- [Web app flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow))\n\n### Ruby\n\n- [Service account flow](//github.com/googleads/google-api-ads-ruby/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/google-api-ads-ruby/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n\u003cbr /\u003e\n\nIf you choose not to use one of our client libraries, you'll need to implement\nthe OAuth2 [service account](/identity/protocols/OAuth2ServiceAccount) or [web\napp](/identity/protocols/OAuth2WebServer) flow yourself.\n\nBehind the scenes\n-----------------\n\nOur client libraries automatically take care of the details covered below so\nonly read on if you're interested in what's happening behind the scenes.\nThis section is intended for advanced users who are already familiar\nwith the [OAuth2 specification](http://tools.ietf.org/html/rfc6749) and\nknow how to [use OAuth2 with Google APIs](/accounts/docs/OAuth2).\n\n#### HTTP request header\n\nThe HTTP header in every request to the Ad Manager API must include an access\ntoken in this form: \n\n```actionscript-3\nAuthorization: Bearer ACCESS_TOKEN\n```\n\nFor example: \n\n```http\nPOST ... HTTP/1.1\nHost: ...\nAuthorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg\nContent-Type: text/xml;charset=UTF-8\nContent-Length: ...\n\n\u003c?xml version=\"1.0\"?\u003e\n\u003csoap:Envelope xmlns:soap=\"http://www.w3.org/2001/12/soap-envelope\"\u003e\n…\n\u003c/soap:Envelope\u003e\n```\n\n#### Scope\n\nA single access token can grant varying degrees of access to multiple APIs. A\nvariable parameter called `scope` controls the set of resources and\noperations that an access token permits. During the access token request, your\napplication sends one or more values in the `scope` parameter.\n\nAd Manager has only one scope, shown below. Authorization should be performed\nat the user level within the product.\n\n| Scope | Permissions |\n|---------------------------------------|-----------------------------------------------|\n| `https://www.googleapis.com/auth/dfp` | View and manage your campaigns on Ad Manager. |"]]
