自
2025 年 9 月 8 日起,每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明,系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明,請參閱
淘汰項目頁面。
總覽
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用者存取權會管理使用者在 Display & Video 360 產品中可執行的作業。使用者會根據在驗證期間使用的 Google 帳戶識別。使用者的存取權限取決於其指派的使用者角色,這些角色會連結至 Display & Video 360 Partner
或 Advertiser
資源。
本指南說明如何尋找及建立使用者,以及透過 Display & Video 360 API 指派使用者角色。
必要條件
開始使用 Display & Video 360 API 使用者服務前,您必須完成下列步驟。請與團隊中現有的管理員使用者聯絡,視需要啟用必要的 Display & Video 360 使用者角色:
按照開始使用指南的說明,建立並授權 API 專案。
請務必遵循服務帳戶的授權流程。只有服務帳戶可以存取 Display & Video 360 API users
服務。驗證程序中也必須使用 特定於 users
服務的 OAuth 範圍。
請確認服務帳戶是 Display & Video 360 使用者,且具備必要資源的必要使用者角色。只有管理員角色可以變更使用者和其指派的使用者角色。任何其他標準角色都只會授予您使用者資源的讀取權。
瞭解使用者角色
指派的使用者角色會決定使用者對不同 Display & Video 360 廣告放送資源的存取層級。關於使用者角色的重要注意事項包括:
使用者角色也會控管您可以存取哪些其他使用者,以及您是否可以建立使用者或修改其他使用者指派的角色。使用者只能看到與其共用相同資源存取權的使用者。舉例來說,如果您對夥伴資源擁有標準存取權,則所有可存取該夥伴或其下任何廣告客戶的使用者,都會納入 users.list
方法回應中。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eDisplay & Video 360 user access is determined by assigned user roles linked to Partner or Advertiser resources.\u003c/p\u003e\n"],["\u003cp\u003eThis guide explains how to find, create, and assign user roles to users through the Display & Video 360 API using service accounts.\u003c/p\u003e\n"],["\u003cp\u003eOnly Admin user roles can modify users and their roles; other roles only provide read access to user resources.\u003c/p\u003e\n"],["\u003cp\u003eUser access is limited to resources they share with other users, meaning visibility is restricted to users with overlapping resource access.\u003c/p\u003e\n"],["\u003cp\u003eUser roles can be assigned at the Partner or Advertiser level, with some roles specific to a resource type and Partner-level roles granting access to all advertisers under that Partner.\u003c/p\u003e\n"]]],["Users in Display & Video 360 are identified by their Google account, and their actions are dictated by assigned roles linked to Partner or Advertiser resources. To use the API, an API project needs authorization, and only service accounts can access the user service with a specific OAuth scope. Admin users can create and modify users and roles; others can only read. User roles grant access to resources; roles at the partner level automatically apply to all advertisers. Users can only see those with access to the same resources.\n"],null,["# Overview\n\nUser access governs the operations individuals can do within the\nDisplay \\& Video 360 product. [Users](/display-video/api/reference/rest/current/users) are identified by the Google\naccount used during authentication. The extent of a user's access is determined\nby their assigned user roles, which are linked to Display \\& Video 360\n[`Partner`](/display-video/api/reference/rest/current/partners) or [`Advertiser`](/display-video/api/reference/rest/current/advertisers) resources.\n\nThis guide describes how to find and create users, as well as assign them user\nroles through the Display \\& Video 360 API.\n\nPrerequisites\n-------------\n\nBefore you start working with Display \\& Video 360 API User services, you'll need to\ncomplete the following steps. Contact an existing **Admin** user on your team to\nhave the necessary Display \\& Video 360 user roles enabled, if necessary:\n\n1. Create and authorize an API project as outlined in our\n [Get Started](/display-video/api/guides/getting-started) guide.\n\n2. Ensure that you're following the [service account](/display-video/api/guides/how-tos/service-account)\n flow for authorization. Only service accounts can access the Display \\& Video 360 API\n [`users`](/display-video/api/reference/rest/current/users) service. An [OAuth scope specific to the `users`\n service](/display-video/api/reference/rest/current/users/get#authorization-scopes) must also be used in the authentication process.\n\n3. Ensure that the service account is a Display \\& Video 360 user, and has the\n requisite [user roles](//support.google.com/displayvideo/answer/2723011) for the necessary resources. Only the\n [Admin](/display-video/api/reference/rest/current/users#UserRole.ENUM_VALUES.ADMIN) role allows you to make changes to a user and their\n assigned user roles. Any other [standard role](//support.google.com/displayvideo/answer/2723011#user-roles) only gives\n you read access to user resources.\n\nUnderstand user roles\n---------------------\n\nAssigned user roles determine the level of access users have to different\nDisplay \\& Video 360 ad-serving resources. Important things to know about user\nroles include:\n\n- A user role can be given for two different resource types:\n [`Advertiser`](/display-video/api/reference/rest/current/advertisers) and [`Partner`](/display-video/api/reference/rest/current/partners).\n\n- Some user roles can only be assigned for a specific resource type.\n\n- A user role assigned for a partner automatically grants that level of access\n to all advertisers under that partner.\n\nUser roles also control which other users you have access to, and whether you\ncan create users and or modify others' assigned roles. **As a user, you can\nonly see users who share access to the same resource.** For example, if you\nhave standard access to a partner resource, all users who have access to that\npartner or any of the advertisers under it will be included in a\n[`users.list`](/display-video/api/reference/rest/current/users/list) method response."]]