Method: mobiledevices.list

Retrieves a paginated list of all mobile devices for an account.

HTTP request

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

The unique ID for the customer's G Suite account. As an account administrator, you can also use the my_customer alias to represent your account's customerId. The customerId is also returned as part of the Users resource.

Query parameters

Parameters
maxResults

integer

Maximum number of results to return. Max allowed value is 100.

orderBy

enum (OrderBy)

Device property to use for sorting results.

pageToken

string

Token to specify next page in the list

projection

enum (Projection)

Restrict information returned to a set of selected fields.

query

string

Search string in the format given at http://support.google.com/a/bin/answer.py?answer=1408863#search

sortOrder

enum (SortOrder)

Whether to return results in ascending or descending order. Must be used with the orderBy parameter.

Request body

The request body must be empty.

Response body

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

JSON representation
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Fields
kind

string

Kind of resource this is.

etag

string

ETag of the resource.

mobiledevices[]

object (MobileDevice)

asps.list of Mobile Device objects.

nextPageToken

string

Token used to access next page of this result.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

For more information, see the OAuth 2.0 Overview.

OrderBy

Enums
ORDER_BY_UNDEFINED
DEVICE_ID The serial number for a Google Sync mobile device. For Android devices, this is a software generated unique identifier.
EMAIL The device owner's email address.
LAST_SYNC Last policy settings sync date time of the device.
MODEL The mobile device's model.
NAME The device owner's user name.
OS The device's operating system.
STATUS The device status.
TYPE Type of the device.

Projection

Enums
PROJECTION_UNDEFINED
BASIC Includes only the basic metadata fields (e.g., deviceId, model, status, type, and status)
FULL Includes all metadata fields

SortOrder

Enums
SORT_ORDER_UNDEFINED
ASCENDING Ascending order.
DESCENDING Descending order.