自
2025 年 9 月 8 日起，每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明，请参阅我们的
弃用页面。
概览
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
用户访问权限用于管理个人可以在 Display & Video 360 产品中执行的操作。用户是指在身份验证期间使用的 Google 账号。用户的访问权限范围取决于分配给他们的用户角色，这些角色与 Display & Video 360 Partner 或 Advertiser 资源相关联。
本指南介绍了如何通过 Display & Video 360 API 查找和创建用户，以及向用户分配用户角色。
前提条件
在开始使用 Display & Video 360 API User 服务之前，您需要先完成以下步骤。如有必要，请与您团队中现有的管理员用户联系，以启用必要的 Display & Video 360 用户角色：
根据使用入门指南中的说明创建一个 API 项目，并向其授权。
确保您遵循服务账号授权流程。只有服务账号才能访问 Display & Video 360 API users 服务。在身份验证过程中，还必须使用特定于 users 服务的 OAuth 范围。
确保该服务账号是 Display & Video 360 用户，并且具有对必要资源的必要用户角色。只有管理员角色才能更改用户及其分配的用户角色。任何其他标准角色只会为您提供对用户资源的读取权限。
了解用户角色
分配的用户角色决定了用户对不同 Display & Video 360 广告投放资源的访问权限级别。有关用户角色的重要须知事项包括：
用户角色还会控制您对哪些其他用户拥有访问权限，以及您能否创建用户和/或修改他人分配的角色。作为用户，您只能看到与您共享同一资源访问权限的用户。例如，如果您对某个合作伙伴资源拥有标准访问权限，则对该合作伙伴或其名下任何广告客户拥有访问权限的所有用户都将包含在 users.list 方法响应中。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：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."]]
