如需了解此资源的方法列表,请参阅本页结尾部分。
资源表示形式
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 。
可接受的值包括:
|
|
displayName |
string |
显示在界面中的名称。创建由 EMM 管理的用户时,是否设置此属性是可选操作。如果您设置了此属性,请使用一些笼统的名称(如“Example, Inc.”)或您的姓名(如 EMM)。不用于 Google 管理的用户帐号。 | 可写入 |
id |
string |
用户的唯一 ID。 |
|
kind |
string |
||
managementType |
string |
管理用户的实体。对于 googleManaged 用户,可信来源是 Google,因此 EMM 必须确保该用户拥有 Google 账号。对于 emmManaged 位用户,EMM 由您负责。可接受的值包括:
|
|
primaryEmail |
string |
用户的主电子邮件地址,例如“jsmith@example.com”。将始终针对由 Google 管理的用户进行设置,而不会针对由 EMM 管理的用户进行设置。 |
方法
- 删除
- 已删除受 EMM 管理的用户。
- generateAuthenticationToken
- 生成一个身份验证令牌,设备政策客户端可以使用该令牌在设备上预配指定的 EMM 管理的用户帐号。生成的令牌是一次性令牌,会在几分钟后过期。
您最多可以为每位用户配置 10 台设备。
此通话仅适用于由 EMM 管理的账号。 - get
- 检索用户的详细信息。
- getAvailableProductSet
- 检索用户有权访问的一组商品。
- insert
- 创建由 EMM 管理的新用户。
在请求正文中传递的 Users 资源应包含accountIdentifier
和accountType
。如果已存在具有相同帐号标识符的对应用户,将使用资源更新该用户。在这种情况下,只能更改
displayName
字段。 - list
- 按主电子邮件地址查找用户。只有由 Google 管理的用户支持此设置。受 EMM 管理的用户无需查找该 ID,因为该 ID 已在 Users.insert 调用的结果中返回。
- revokeDeviceAccess
- 撤消对目前已配置给用户的设备的访问权限。用户将无法再在其任何受管设备上使用 Play 企业版商店。
此通话仅适用于由 EMM 管理的账号。 - setAvailableProductSet
- 修改用户有权访问的一组产品(称为白名单产品)。whitelisted只有已获批准的产品或之前已获批准(被撤消审批的产品)的产品才能列入白名单。
- update
- 更新由 EMM 管理的用户的详细信息。
只能与受 EMM 管理的用户(而非由 Google 管理的用户)搭配使用。 在请求正文中的 Users 资源中传递新详细信息。只能更改displayName
字段。其他字段必须未设置或具有当前有效值。