Lists/Searches devices.
HTTP request
GET https://cloudidentity.googleapis.com/v1beta1/devices
The URL uses gRPC Transcoding syntax.
Query parameters
Parameters | |
---|---|
customer
|
Optional. Resource name of the customer. |
filter
|
Optional. Additional restrictions when fetching list of devices. For a list of search fields, refer to Mobile device search fields . Multiple search fields are separated by the space character. |
pageSize
|
Optional. The maximum number of Devices to return. If unspecified, at most 20 Devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. |
pageToken
|
Optional. A page token, received from a previous When paginating, all other parameters provided to |
orderBy
|
Optional. Order specification for devices in the response. Only one of the following field names may be used to specify the order: |
view
|
Optional. The view to use for the List request. |
Request body
The request body must be empty.
Response body
Response message that is returned from the devices.list method.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"devices"
:
[
{
object (
|
Fields | |
---|---|
devices[]
|
Devices meeting the list restrictions. |
nextPageToken
|
Token to retrieve the next page of results. Empty if there are no more results. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/cloud-identity.devices.readonly
-
https://www.googleapis.com/auth/cloud-identity.devices
-
https://www.googleapis.com/auth/cloud-identity
For more information, see the Authentication Overview .
View
The view determines which devices and device info are present in the response.
Enums | |
---|---|
VIEW_UNSPECIFIED
|
Default value. The value is unused. |
COMPANY_INVENTORY
|
This view contains all devices imported by the company admin. Each device in the response contains all information specified by the company admin when importing the device (i.e. asset tags). |
USER_ASSIGNED_DEVICES
|
This view contains all devices with at least one user registered on the device. Each device in the response contains all device information, except for asset tags. |