Users: list

  • This API call looks up a Google-managed user by their primary email address.

  • EMM-managed users do not require this lookup because their ID is returned during the insert call.

  • The request requires authorization and uses a GET HTTP method with the enterprise ID and the user's email as parameters.

  • The response returns a list containing the user resource if successful.

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".