Para obtener una lista de métodos para este recurso, consulta al final de esta página.
Representaciones de recursos
Un recurso de usuarios representa una cuenta asociada con una empresa. Es posible que la cuenta sea específica para un dispositivo o un usuario individual (que puede usarla en varios dispositivos). La cuenta solo puede proporcionar acceso a Google Play administrado o a otros servicios de Google, según el modelo de identidad:
- El modelo de identidad de dominio administrado por Google requiere sincronización con las fuentes de la Cuenta de Google (a través de
primaryEmail
). - El modelo de identidad de cuentas de Google Play administrada proporciona un medio dinámico para que las empresas creen cuentas de usuarios o dispositivos según sea necesario. Estas cuentas proporcionan acceso a Google Play administrado.
{ "kind": "androidenterprise#user", "id": string, "managementType": string, "accountType": string, "primaryEmail": string, "accountIdentifier": string, "displayName": string }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
accountIdentifier |
string |
Un identificador único que creas para este usuario, como "user342" o "asset#44418". No uses información de identificación personal (PII) en esta propiedad. Siempre se debe configurar para los usuarios administrados por EMM. No se estableció para usuarios administrados por Google. | |
accountType |
string |
Es el tipo de cuenta que representa este usuario. Un userAccount se puede instalar en varios dispositivos, pero un deviceAccount es específico de uno solo. Un usuario administrado por EMM (emmManaged ) puede ser de cualquier tipo (userAccount , deviceAccount ), pero un usuario administrado por Google (googleManaged ) siempre es userAccount .
Los valores aceptables son los siguientes:
|
|
displayName |
string |
Es el nombre que aparecerá en las interfaces de usuario. Configurar esta propiedad es opcional cuando se crean usuarios administrados por EMM. Si configuras esta propiedad, usa algo genérico sobre la organización (como "Ejemplo, Inc.") o tu nombre (como EMM). No se usa en las cuentas de usuario administradas por Google. | admite escritura |
id |
string |
El ID único del usuario. |
|
kind |
string |
||
managementType |
string |
Es la entidad que administra al usuario. Con los usuarios de googleManaged , la fuente de información es Google, por lo que los EMM deben asegurarse de que exista una Cuenta de Google para el usuario. Con emmManaged usuarios, la EMM está a cargo.
Los valores aceptables son los siguientes:
|
|
primaryEmail |
string |
La dirección de correo electrónico principal del usuario; por ejemplo, "jsmith@example.com". Siempre se establecerá para los usuarios administrados por Google y no se establecerá para los usuarios administrados por EMM. |
Métodos
- borrar
- Se borró un usuario administrado por EMM.
- generateAuthenticationToken
- Genera un token de autenticación que el cliente de política de dispositivo puede usar para aprovisionar la cuenta de usuario determinada administrada por EMM en un dispositivo.
El token generado es de un solo uso y expira después de unos minutos.
Puedes aprovisionar un máximo de 10 dispositivos por usuario.
Esta llamada solo funciona con cuentas administradas por EMM. - get
- Recupera los detalles de un usuario.
- getAvailableProductSet
- Recupera el conjunto de productos a los que un usuario tiene derecho a acceder.
- insertar
- Crea un usuario nuevo administrado por EMM.
El recurso Users que se pasó en el cuerpo de la solicitud debe incluiraccountIdentifier
yaccountType
.Si un usuario correspondiente ya existe con el mismo identificador de cuenta, el usuario se actualizará con el recurso. En este caso, solo se puede cambiar el campo
displayName
. - list
- Busca a un usuario por su dirección de correo electrónico principal. Esta opción solo se admite para los usuarios administrados por Google. Los usuarios administrados por EMM no necesitan buscar el ID porque el ID ya se muestra como resultado de la llamada Users.insert.
- revokeDeviceAccess
- Revoca el acceso a todos los dispositivos aprovisionados actualmente al usuario. El usuario ya no podrá usar Play Store administrado en ninguno de sus dispositivos administrados.
Esta llamada solo funciona con cuentas administradas por EMM. - setAvailableProductSet
- Modifica el conjunto de productos a los que un usuario tiene derecho a acceder (denominados productos whitelisted). Solo se pueden incluir en la lista blanca los productos que están aprobados o los que se aprobaron con anterioridad (productos con aprobación revocada).
- actualización
- Actualiza los detalles de un usuario administrado por EMM.
Solo se puede usar con usuarios administrados por EMM (no con usuarios administrados por Google). Pasa los detalles nuevos en el recurso Usuarios en el cuerpo de la solicitud. Solo se puede cambiar el campodisplayName
. Otros campos deben no estar configurados o tener el valor activo en ese momento.