Users

有关此类资源的方法列表，请参阅本页面的结尾部分。

资源表示形式

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。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “deviceAccount”
  • “userAccount”
displayName string 显示在界面中的名称。创建由 EMM 管理的用户时，是否设置此属性是可选操作。如果您设置了此属性，请使用一些笼统的名称（如“Example, Inc.”）或您的姓名（如 EMM）。不用于 Google 管理的用户账号。 可写入
id string 用户的唯一 ID。
kind string
managementType string 管理用户的实体。对于 googleManaged 用户，可信来源是 Google，因此 EMM 必须确保该用户拥有 Google 账号。若有 emmManaged 位用户，则由 EMM 负责。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “emmManaged”
  • “googleManaged”
primaryEmail string 用户的主电子邮件地址，例如“jsmith@example.com”。将始终针对由 Google 管理的用户进行设置，而不会针对由 EMM 管理的用户进行设置。

方法

delete
已删除受 EMM 管理的用户。
generateAuthenticationToken
生成一个身份验证令牌，设备政策客户端可使用该令牌执行以下操作： 在设备上配置指定 EMM 管理的用户账号。 生成的令牌是一次性令牌，会在几分钟后过期。

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

此通话仅支持由 EMM 管理的账号。
get
检索用户的详细信息。
getAvailableProductSet
检索用户有权访问的一组商品。
insert
创建由 EMM 管理的新用户。

Users 资源 并在请求正文中传递，应包含一个 accountIdentifier 和 accountType。

如果已存在具有相同账号标识符的相应用户， 系统就会使用相应资源更新用户在此例中，只有 displayName 字段可以更改。

list
按主电子邮件地址查找用户。 只有由 Google 管理的用户支持此设置。ID 的查找结果不是 因为此 ID 已在 调用 Users.insert 调用的结果
revokeDeviceAccess
撤消对目前已配置给用户的设备的访问权限。用户 将无法再在任何计算机上使用 Google Play 企业版商店 受管理的设备

此通话仅支持由 EMM 管理的账号。
setAvailableProductSet
修改用户有权访问的一组产品（称为 列入白名单的商品）。只有 已批准 或之前获得批准的商品（审批结果被撤消的商品） 可以列入白名单
update
更新由 EMM 管理的用户的详细信息。

只能与受 EMM 管理的用户（而非 Google 管理的用户）搭配使用。 在 用户 添加相应的资源仅 displayName 字段 可以更改其他字段必须取消设置或使用 当前有效值。