Method: customers.telemetry.devices.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetlanie listy wszystkich urządzeń telemetrycznych.
Żądanie HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
parent |
string
Wymagane. Identyfikator klienta lub „my_customer” , aby użyć konta klienta powiązanego z kontem, z którego wysłano prośbę.
|
Parametry zapytania
| Parametry |
filter |
string
Opcjonalnie: Uwzględnij tylko zasoby pasujące do filtra. Żądania bez określonego parametru „reports_timestamp” domyślnie zwracają tylko ostatnie raporty. Określ parametr „reports_timestamp>=0” aby wyświetlić wszystkie dane z raportu. Obsługiwane pola filtrów: - orgUnitId
- serialNumber
- deviceId
- reports_timestamp
Parametr „reports_timestamp” filtr akceptuje format milisekund uniksowego stylu uniksowego lub RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi po przecinku. Oba formaty powinny być umieszczone w podwójnych cudzysłowach. Przykłady: „2014-10-02T15:01:23Z”, „2014-10-02T15:01:23.045123456Z”, „1679283943823”.
|
readMask |
string (FieldMask format)
Wymagane. Przeczytaj maskę, aby określić pola, które mają być zwracane. Obsługiwane ścieżki readMask: - nazwa
- 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
Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".
|
pageSize |
integer
Maksymalna liczba wyników do zwrócenia. Wartość domyślna to 100. Maksymalna wartość to 1000.
|
pageToken |
string
Token do określenia następnej strony na liście.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"devices": [
{
object (TelemetryDevice)
}
],
"nextPageToken": string
} |
| Pola |
devices[] |
object (TelemetryDevice)
Urządzenia telemetryczne zwrócone w odpowiedzi.
|
nextPageToken |
string
Token do określenia następnej strony na liście.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\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`"]]
