Method: enterprises.devices.list

  • This document details how to list devices for a given enterprise using an HTTP GET request.

  • The request uses path parameters to specify the enterprise ID and can include query parameters for pagination.

  • The request body must be empty, and the response body contains a list of devices and a token for the next page of results if applicable.

  • The request requires the https://www.googleapis.com/auth/androidmanagement authorization scope.

Lists devices for a given enterprise. Deleted devices are not returned in the response.

HTTP request

GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the enterprise in the form enterprises/{enterpriseId}.

Query parameters

Parameters
pageSize

integer

The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time.
pageToken

string

A token identifying a page of results returned by the server.

Request body

The request body must be empty.

Response body

Response to a request to list devices for a given enterprise.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
Fields
devices[]

object (Device)

The list of devices.
nextPageToken

string

If there are more results, a token to retrieve next page of results.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/androidmanagement

For more information, see the OAuth 2.0 Overview.