REST Resource: users

资源：User

Display & Video 360 中的单个用户。

JSON 表示法 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
字段
name

string

仅供输出。用户的资源名称。
userId

string (int64 format)

仅供输出。用户的唯一 ID。由系统分配。
email

string

必需。不可变。用于标识用户的电子邮件地址。
displayName

string

必需。用户的显示名。

必须采用 UTF-8 编码，大小上限为 240 个字节。
assignedUserRoles[]

object (AssignedUserRole)

已分配的用户角色。

在 users.create 中是必需的。仅在 users.patch 中输出。只能通过 users.bulkEditAssignedUserRoles 进行更新。
lastLoginTime

string (Timestamp format)

仅供输出。用户上次登录 DV360 界面时的时间戳。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

AssignedUserRole

分配的一个用户角色，用于定义用户与指定合作伙伴或广告客户的授权互动。

JSON 表示法 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
字段
assignedUserRoleId

string

仅供输出。已分配用户角色的 ID。
userRole

enum (UserRole)

必需。要分配给用户的用户角色。

联合字段 entity_id。必填。

所分配的用户角色应用到的实体 ID。entity_id 只能是下列其中一项：
partnerId

string (int64 format)

所分配用户角色适用的合作伙伴的 ID。
advertiserId

string (int64 format)

分配用户角色适用的广告客户的 ID。

UserRole

可能的用户角色。

枚举
USER_ROLE_UNSPECIFIED 此版本中未指定或未知用户角色时的默认值。
ADMIN 用户可以管理该实体的广告系列、广告素材、广告订单、订单项和报表。他们可以查看和修改结算信息、创建或修改用户，以及启用或停用广告交易平台。此角色只能分配给合作伙伴实体。
ADMIN_PARTNER_CLIENT 用户可以管理该实体的广告系列、广告素材、广告订单、订单项和报表。他们可以创建和修改其他“ADMIN_PARTNER_CLIENT”用户以及查看结算信息。但无法查看收入模式、加价或任何其他涉及转销商的敏感字段。此角色只能分配给合作伙伴实体。
STANDARD 用户可以管理该实体的广告系列、广告素材、广告订单、订单项和报表。他们不能创建和修改用户，也不能查看结算信息。
STANDARD_PLANNER 用户可以查看此实体的所有广告系列、广告素材、广告订单、订单项和报表，包括所有费用数据。他们可以创建和修改与规划相关的功能，包括方案和广告资源。
STANDARD_PLANNER_LIMITED 用户可以查看该实体的所有广告系列、广告素材、广告订单、订单项和报表。他们可以创建或修改与规划相关的功能，包括方案和广告资源。他们无权访问费用数据，也无法开始、接受或协商交易。
STANDARD_PARTNER_CLIENT 用户可以管理该实体的广告系列、广告素材、广告订单、订单项和报表。他们不能创建或修改其他用户，也不能查看结算信息。但无法查看收入模式、加价或任何其他涉及转销商的敏感字段。只能为广告客户实体分配此角色。
READ_ONLY 用户只能针对实体生成报告和查看数据。
REPORTING_ONLY 此类用户只能创建和管理报告。
LIMITED_REPORTING_ONLY 用户只能创建和管理以下可与客户分享的报表：“常规”“受众群体效果”“跨合作伙伴”“关键字”“订单 ID”“类别”和“第三方数据提供商”。
CREATIVE 此类用户可以查看进行协作所需的媒体策划方案信息，但无法查看费用相关数据或“市场”。
CREATIVE_ADMIN 此类用户可以查看进行协作所需的媒体策划方案信息，但无法查看费用相关数据或“市场”。此外，他们还可以向该实体添加其他广告素材管理员或广告素材用户。

方法

bulkEditAssignedUserRoles

 批量修改用户的用户角色。

create

 创建新用户。

delete

 删除用户。

get

 获取用户。

list

 列出当前用户可以访问的用户。

patch

 更新现有用户。