Users: list

  • Looks up a Google-managed user within a specific enterprise using their primary email address.

  • Requires authorization with the https://www.googleapis.com/auth/androidenterprise scope.

  • Sends an HTTP GET request to the specified URL with enterprise ID and email as parameters.

  • The response includes a list of users matching the provided email, if found within the enterprise.

  • This method is not applicable for EMM-managed users as their IDs are obtained during the user creation process.

Looks up a user by primary email address. This is only supported for Google-managed users. Lookup of the id is not needed for EMM-managed users because the id is already returned in the result of the Users.insert call.

Request

HTTP request

GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users

Parameters

Parameter name Value Description
Path parameters
enterpriseId string The ID of the enterprise.
Required query parameters
email string The exact primary email address of the user to look up.

Authorization

This request requires authorization with the following scope:

Scope
https://www.googleapis.com/auth/androidenterprise

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "androidenterprise#usersListResponse",
  "user": [
    users Resource
  ]
}
Property name Value Description Notes
user[] list A user of an enterprise.
kind string Identifies what kind of resource this is. Value: the fixed string "androidenterprise#usersListResponse".