Users

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:
  • "deviceAccount"
  • "userAccount"
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:
  • "emmManaged"
  • "googleManaged"
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 incluir accountIdentifier y accountType.

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 campo displayName. Otros campos deben no estar configurados o tener el valor activo en ese momento.