Method: customers.telemetry.devices.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices
网址采用 gRPC 转码语法。
路径参数
| 参数 |
parent |
string
必需。客户 ID 或“my_customer”以使用与发出请求的账号相关联的客户。
|
查询参数
| 参数 |
filter |
string
可选。仅包含与过滤条件匹配的资源。未指定“reports_timestamp”的请求值将默认仅返回最近的报告。指定“reports_timestamp>=0”来获取所有报告数据。 支持的过滤条件字段： - orgUnitId
- serialNumber
- deviceId
- reports_timestamp
“reports_timestamp”过滤器接受 Unix Epoch 毫秒格式或 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）采用纳秒级精度和最多九个小数位。这两种格式都应用简单的双引号括起来。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"1679283943823"。
|
readMask |
string (FieldMask format)
必需。读取掩码以指定要返回的字段。 支持的 readMask 路径包括： - 名称
- 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
这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
|
pageSize |
integer
返回的结果数上限。默认值为 100。最大值为 1000。
|
pageToken |
string
用于指定列表中下一页的令牌。
|
响应正文
| JSON 表示法 |
{
"devices": [
{
object (TelemetryDevice)
}
],
"nextPageToken": string
} |
| 字段 |
devices[] |
object (TelemetryDevice)
响应中返回的遥测设备。
|
nextPageToken |
string
用于指定列表中下一页的令牌。
|
授权范围
需要以下 OAuth 范围：
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003eList all telemetry devices for a given customer.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by org unit ID, serial number, device ID, and report timestamp.\u003c/p\u003e\n"],["\u003cp\u003eControl which fields are returned using a read mask.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated with a page size and token for navigation.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListTelemetryDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList all telemetry devices.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Customer id or \"my_customer\" to use the customer associated to the account making the request. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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\\\u003e=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\". \u003cbr /\u003e |\n| `readMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` 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 \u003cbr /\u003e This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `pageSize` | `integer` Maximum number of results to return. Default value is 100. Maximum value is 1000. |\n| `pageToken` | `string` Token to specify next page in the list. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/chrome/management/reference/rest/v1/customers.telemetry.devices#TelemetryDevice) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[TelemetryDevice](/chrome/management/reference/rest/v1/customers.telemetry.devices#TelemetryDevice)`)` Telemetry devices returned in the response. |\n| `nextPageToken` | `string` Token to specify next page in the list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`"]]
