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. |
page |
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. |
page |
Optional. A page token, received from a previous When paginating, all other parameters provided to |
order |
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. |
next |
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. |