Importante: Ya no aceptamos registros nuevos para la API de EMM de Play.
Más información
Users: insert
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea un nuevo usuario administrado 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.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parámetros
| Nombre del parámetro |
Valor |
Descripción |
| Parámetros de ruta de acceso |
enterpriseId |
string |
El ID de la empresa.
|
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
| Alcance |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un Recurso de usuarios con las siguientes propiedades:
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
| Propiedades obligatorias |
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 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"
|
|
Respuesta
Si se aplica correctamente, este método muestra un recurso de usuarios en el cuerpo de la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 2025-07-26 (UTC)"],[[["\u003cp\u003eCreates or updates an EMM-managed user within a specified enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eaccountIdentifier\u003c/code\u003e and \u003ccode\u003eaccountType\u003c/code\u003e to define the user.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003e/enterprises/enterpriseId/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edisplayName\u003c/code\u003e is the only field that can be updated for existing users.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["# Users: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates a new EMM-managed user.\n\n\u003cbr /\u003e\n\n\nThe [Users](/android/work/play/emm-api/v1/users) resource\npassed in the body of the request should include an\n`accountIdentifier` and an `accountType`.\n\nIf a corresponding user already exists with the same account identifier,\nthe user will be updated with the resource. In this case only the\n`displayName` field can be changed.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Users resource](/android/work/play/emm-api/v1/users#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\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\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
