Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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 está configurado 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
Es 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.
Genera un token de autenticación que el cliente de política de dispositivo puede usar para
aprovisionar la cuenta de usuario 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.
El recurso Users
pasado en el cuerpo de la solicitud debe incluir un
accountIdentifier y un accountType.
Si ya existe un usuario con el mismo identificador de cuenta,
el usuario se actualizará con el recurso. En este caso, solo el
Se puede cambiar el campo displayName.
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. La búsqueda del ID no es
necesario para los usuarios administrados por EMM porque el ID ya se devuelve
resultado de la llamada Users.insert.
Revoca el acceso a todos los dispositivos aprovisionados actualmente al usuario. El usuario
ya no podrán usar Play Store administrado en ninguno de sus
en dispositivos administrados.
Esta llamada solo funciona con cuentas administradas por EMM.
Modifica el conjunto de productos a los que un usuario tiene derecho a acceder (en adelante,
como productos incluidos en la lista blanca). Solo los productos que son
aprobado
o productos aprobados previamente (productos con aprobación revocada)
se pueden incluir en la lista blanca.
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 nuevos detalles en la
Usuarios
recurso en el cuerpo de la solicitud. Solo el campo displayName
que se puede cambiar. Otros campos deben estar desactivados o tener la
valor activo actualmente.
[null,null,["Última actualización: 2024-08-19 (UTC)"],[[["\u003cp\u003eA Users resource represents an enterprise account that can be device- or individual-specific, granting access to managed Google Play and potentially other Google services based on the chosen identity model.\u003c/p\u003e\n"],["\u003cp\u003eTwo identity models are available: Google-managed domain identity (requiring synchronization with Google accounts) and managed Google Play Accounts (allowing dynamic creation of user/device accounts for Play access).\u003c/p\u003e\n"],["\u003cp\u003eEMM-managed users have unique identifiers and account types, while Google-managed users rely on primary email addresses for identification.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage users using various methods like creating, deleting, retrieving details, and controlling device access, with options varying based on management type.\u003c/p\u003e\n"],["\u003cp\u003eSome methods, like \u003ccode\u003egetAvailableProductSet\u003c/code\u003e and \u003ccode\u003esetAvailableProductSet\u003c/code\u003e, are deprecated and will be inaccessible after September 30, 2025, with alternative recommendations available.\u003c/p\u003e\n"]]],[],null,["# Users\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nA Users resource represents an account associated with an enterprise. The account may be specific to a device or to an individual user (who can then use the account across multiple devices). The account may provide access to managed Google Play only, or to other Google services, depending on the identity model:\n\n- The Google managed domain identity model requires synchronization to Google account sources (via `primaryEmail`).\n- The managed Google Play Accounts identity model provides a dynamic means for enterprises to create user or device accounts as needed. These accounts provide access to managed Google Play.\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#user\",\n \"id\": string,\n \"managementType\": string,\n \"accountType\": string,\n \"primaryEmail\": string,\n \"accountIdentifier\": string,\n \"displayName\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n| `id` | `string` | The unique ID for the user. | |\n| `kind` | `string` | | |\n| `managementType` | `string` | The entity that manages the user. With `googleManaged` users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With `emmManaged` users, the EMM is in charge. \u003cbr /\u003e Acceptable values are: - \"`emmManaged`\" - \"`googleManaged`\" | |\n| `primaryEmail` | `string` | The user's primary email address, for example, \"jsmith@example.com\". Will always be set for Google managed users and not set for EMM managed users. | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/users/delete)\n: Deleted an EMM-managed user.\n\n[generateAuthenticationToken](/android/work/play/emm-api/v1/users/generateAuthenticationToken)\n: Generates an authentication token which the device policy client can use to\n provision the given EMM-managed user account on a device.\n The generated token is single-use and expires after a few minutes.\n\n \u003cbr /\u003e\n\n\n You can provision a maximum of 10 devices per user.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[get](/android/work/play/emm-api/v1/users/get)\n: Retrieves a user's details.\n\n[getAvailableProductSet](/android/work/play/emm-api/v1/users/getAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Retrieves the set of products a user is entitled to access.\n\n[insert](/android/work/play/emm-api/v1/users/insert)\n: Creates a new EMM-managed user.\n\n \u003cbr /\u003e\n\n\n The [Users](/android/work/play/emm-api/v1/users) resource\n passed in the body of the request should include an\n `accountIdentifier` and an `accountType`.\n\n If a corresponding user already exists with the same account identifier,\n the user will be updated with the resource. In this case only the\n `displayName` field can be changed.\n\n[list](/android/work/play/emm-api/v1/users/list)\n: Looks up a user by primary email address.\n This is only supported for Google-managed users. Lookup of the id is not\n needed for EMM-managed users because the id is already returned in the\n result of the Users.insert call.\n\n[revokeDeviceAccess](/android/work/play/emm-api/v1/users/revokeDeviceAccess)\n: Revokes access to all devices currently provisioned to the user. The user\n will no longer be able to use the managed Play store on any of their\n managed devices.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Modifies the set of products that a user is entitled to access (referred to\n as *whitelisted* products). Only products that are\n [approved](/android/work/play/emm-api/v1/products/approve)\n or products that were previously approved (products with revoked approval)\n can be whitelisted.\n\n[update](/android/work/play/emm-api/v1/users/update)\n: Updates the details of an EMM-managed user.\n\n \u003cbr /\u003e\n\n\n Can be used with EMM-managed users only (not Google managed users).\n Pass the new details in the\n [Users](/android/work/play/emm-api/v1/users)\n resource in the request body. Only the `displayName` field\n can be changed. Other fields must either be unset or have the\n currently active value."]]
