Importante: não aceitamos mais novos registros para a API Play EMM.
Saiba mais.
Users: list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Procura um usuário pelo endereço de e-mail principal.
Isso só é compatível com usuários gerenciados pelo Google. A pesquisa do ID não é
necessário para usuários gerenciados por EMM porque o ID já foi retornado na
resultado da chamada Users.insert.
Solicitação
Solicitação HTTP
GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
enterpriseId |
string |
O ID da empresa.
|
| Parâmetros de consulta obrigatórios |
email |
string |
O endereço de e-mail principal exato do usuário a ser pesquisado.
|
Autorização
Esta solicitação requer autorização com o seguinte escopo:
| Escopo |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"kind": "androidenterprise#usersListResponse",
"user": [
users Resource
]
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
user[] |
list |
Usuário de uma empresa. |
|
kind |
string |
Identifica o tipo de recurso. Valor: a string fixa "androidenterprise#usersListResponse". |
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 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\"`. | |"]]
