如需了解此资源的方法列表,请参阅本页结尾部分。
资源表示形式
用户资源表示与企业关联的帐号。而帐号可能专用于某个设备或某个用户(可在多个设备上使用该帐号)。相应帐号可能会仅提供对 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 管理的用户设置。 |
方法
- 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
字段。其他字段必须取消设置或具有当前有效的值。