Method: customers.telemetry.devices.list

List all telemetry devices.

HTTP request

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Customer id or "my_customer" to use the customer associated to the account making the request.

Query parameters

Parameters
filter

string

Optional. Only include resources that match the filter. Requests that don't specify a "reports_timestamp" value will default to returning only recent reports. Specify "reports_timestamp>=0" to get all report data.

Supported filter fields:

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
The "reports_timestamp" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC "Zulu" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string (FieldMask format)

Required. Read mask to specify which fields to return.

Supported readMask paths are:

  • name
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

pageSize

integer

Maximum number of results to return. Default value is 100. Maximum value is 1000.

pageToken

string

Token to specify next page in the list.

Request body

The request body must be empty.

Response body

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

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

object (TelemetryDevice)

Telemetry devices returned in the response.

nextPageToken

string

Token to specify next page in the list.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly