Users

如需了解此资源的方法列表，请参阅本页结尾部分。

资源表示形式

用户资源表示与企业关联的帐号。而帐号可能专用于某个设备或某个用户（可在多个设备上使用该帐号）。相应帐号可能会仅提供对 Google Play 企业版的访问权限，也可能会提供对其他 Google 服务的访问权限，具体取决于身份模式：

Google 管理的网域身份模型需要同步到 Google 帐号来源（通过 primaryEmail）。
Google Play 企业版身份模型为企业提供了一种动态创建用户或设备帐号的方式。您可以使用这些帐号访问 Google Play 企业版。

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}

属性名称	值	说明	备注
`accountIdentifier`	`string`	您为此用户创建的唯一标识符，例如“user342”或“asset#44418”。请勿为此资源使用个人身份信息 (PII)。必须始终为 EMM 管理的用户设置此值。不适用于由 Google 管理的用户。
`accountType`	`string`	此用户代表的帐号类型。一个 `userAccount` 可以安装在多台设备上，但 `deviceAccount` 只适用于单个设备。EMM 管理的用户 (`emmManaged`) 可以是类型（`userAccount`、`deviceAccount`），但 Google 管理的用户 (`googleManaged`) 始终是 `userAccount`。可接受的值： “`deviceAccount`” “`userAccount`”
`displayName`	`string`	将在界面中显示的名称。在创建通过 EMM 管理的用户时，可以选择是否设置此属性。如果您设置了此属性，请使用与组织相关的通用名称（例如“Example, Inc.”）或您的姓名（例如 EMM）。不用于由 Google 管理的用户帐号。	可写入
`id`	`string`	用户的唯一 ID。
`kind`	`string`
`managementType`	`string`	管理用户的实体。对于 `googleManaged` 用户，可信来源是 Google，因此 EMM 必须确保该用户存在 Google 帐号。有 `emmManaged` 位用户，EMM 负责。可接受的值： “`emmManaged`” “`googleManaged`”
`primaryEmail`	`string`	用户的主电子邮件地址，例如“jsmith@example.com”。将始终由 Google 管理的用户设置，而不是为 EMM 管理的用户设置。

方法

delete: 删除了企业移动管理 (EMM) 管理的用户。
generateAuthenticationToken: 生成身份验证令牌，设备政策客户端可以使用该令牌在设备上配置指定的 EMM 管理用户帐号。生成的令牌是一次性的，会在几分钟后过期。

您最多可以为每位用户配置 10 台设备。

此通话仅适用于通过 EMM 管理的帐号。
get: 检索用户的详细信息。
getAvailableProductSet: 检索用户有权访问的一组商品。注意：此项已弃用。新集成无法使用此方法，并且可以参考我们的新建议。
插入: 创建通过 EMM 管理的新用户。

在请求正文中传递的 Users 资源应包含 accountIdentifier 和 accountType。
如果已存在使用相同帐号标识符的对应用户，则系统会使用资源更新该用户。在这种情况下，只能更改 displayName 字段。
list: 按主电子邮件地址查找用户。只有 Google 管理的用户才能执行此操作。EMM 管理的用户无需查找该 ID，因为其已在 Users.insert 调用结果中返回。
revokeDeviceAccess: 撤消用户当前所配置的所有设备的访问权限。用户将无法再在其任何受管理设备上使用 Play 商店。

此通话仅适用于通过 EMM 管理的帐号。
setAvailableProductSet: 修改用户有权访问的一组产品（称为“列入白名单的产品”）。只有已批准的产品或之前已获批准的产品（已撤消审批的产品）才能列入白名单。注意：此项已弃用。新集成无法使用此方法，并且可以参考我们的新建议。
update: 更新 EMM 管理的用户的详细信息。

仅适用于通过 EMM 管理的用户（不适用于由 Google 管理的用户）。在请求正文中的 Users 资源中传递新详细信息。只能更改 displayName 字段。其他字段必须取消设置或具有当前有效的值。