Users

Si quieres obtener una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

Un recurso de usuarios representa una cuenta asociada con una empresa. La cuenta puede ser específica de un dispositivo o de un usuario individual (quien puede utilizar la cuenta en varios dispositivos). Según el modelo de identidad, la cuenta puede proporcionar acceso solo a Google Play administrado o a otros servicios de Google:

  • El modelo de identidad de dominio administrado de Google requiere la sincronización con fuentes de la Cuenta de Google (a través de primaryEmail).
  • El modelo de identidad de cuentas de Google Play administrado proporciona un medio dinámico para que las empresas creen cuentas de usuario o dispositivo 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 crea para este usuario, como "user342" o "asset#44418". No uses información de identificación personal (PII) para esta propiedad. Siempre se debe configurar para los usuarios administrados por EMM. No se configuró para los usuarios administrados por Google.
accountType string Es el tipo de cuenta que representa este usuario. Se puede instalar un userAccount en varios dispositivos, pero un deviceAccount es específico para un dispositivo. Un usuario administrado por EMM (emmManaged) puede ser de tipo (userAccount, deviceAccount), pero un usuario administrado por Google (googleManaged) siempre es userAccount.

Los valores aceptables son los siguientes:
  • "deviceAccount"
  • "userAccount"
displayName string El nombre que aparecerá en las interfaces de usuario. Establecer esta propiedad es opcional cuando se crean usuarios administrados por EMM. Si estableces esta propiedad, utiliza un elemento 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 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 el usuario tenga una Cuenta de Google. Con emmManaged usuarios, el 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 de Google, pero no para los usuarios administrados de 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 uso único y vence después de unos minutos.

Puedes aprovisionar un máximo de 10 dispositivos por usuario.

Esta llamada solo funciona con cuentas administradas por EMM.
obtener
Recupera los detalles de un usuario.
getAvailableProductSet
Recupera el conjunto de productos al que un usuario tiene derecho a acceder. Nota: Este elemento ya no está disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.
insertar
Crea un usuario nuevo administrado por EMM.

El recurso Users que se pasa en el cuerpo de la solicitud debe incluir un accountIdentifier y un accountType.

Si ya existe un usuario correspondiente 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. Solo se admite para los usuarios administrados por Google. La búsqueda del ID no es necesaria para los usuarios administrados por EMM porque el ID ya se muestra en el resultado de la llamada Users.insert.
revokeDeviceAccess
Revoca el acceso a todos los dispositivos que se hayan aprovisionado 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 acceso (se conocen como productos incluidos en la lista blanca). Solo se pueden incluir en la lista blanca los productos que están aprobados o los que ya se aprobaron (productos con aprobación revocada). Nota: Este elemento ya no está disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.
actualizar
Actualiza los detalles de un usuario administrado por EMM.

Solo se puede usar con usuarios administrados por EMM (no a usuarios administrados por Google). Pasa los detalles nuevos en el recurso Users, en el cuerpo de la solicitud. Solo se puede cambiar el campo displayName. Los otros campos no deben estar configurados o deben tener el valor activo en este momento.