Importante: Ya no aceptamos registros nuevos para la API de EMM de Play.
Más información
Users: list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Busca 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.
Solicitud
Solicitud HTTP
GET 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.
|
| Parámetros de consulta obligatorios |
email |
string |
La dirección de correo electrónico principal exacta del usuario que se debe buscar.
|
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
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{
"kind": "androidenterprise#usersListResponse",
"user": [
users Resource
]
}
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
user[] |
list |
Usuario de una empresa. |
|
kind |
string |
Identifica qué tipo de recurso es. Valor: la cadena fija "androidenterprise#usersListResponse" |
|
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\u003eLooks up a Google-managed user within a specific enterprise using their primary email address.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eSends an HTTP GET request to the specified URL with enterprise ID and email as parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of users matching the provided email, if found within the enterprise.\u003c/p\u003e\n"],["\u003cp\u003eThis method is not applicable for EMM-managed users as their IDs are obtained during the user creation process.\u003c/p\u003e\n"]]],[],null,["# Users: list\n\n| **Note:** Requires [authorization](#auth).\n\nLooks up a user by primary email address.\nThis is only supported for Google-managed users. Lookup of the id is not\nneeded for EMM-managed users because the id is already returned in the\nresult of the Users.insert call.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET 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| **Required query parameters** |||\n| `email` | `string` | The exact primary email address of the user to look up. |\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\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"androidenterprise#usersListResponse\",\n \"user\": [\n users Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|------------------------------------------------------------------------------------------------------------|-------|\n| `user[]` | `list` | A user of an enterprise. | |\n| `kind` | `string` | Identifies what kind of resource this is. Value: the fixed string `\"androidenterprise#usersListResponse\"`. | |"]]
