Method: customers.telemetry.devices.list

    • You can list all telemetry devices using a GET request to the specified endpoint.

    • The request requires a parent path parameter to specify the customer.

    • Optional query parameters like filter , readMask , pageSize , and pageToken can be used to refine the results.

    • The response body contains a list of devices and a nextPageToken for pagination.

    • This action requires the https://www.googleapis.com/auth/chrome.management.telemetry.readonly authorization scope.

    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
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: