Method: customers.telemetry.devices.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Перечислите все устройства телеметрии.
HTTP-запрос
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Идентификатор клиента или «my_customer», чтобы использовать клиента, связанного с учетной записью, делающей запрос. |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Включайте только ресурсы, соответствующие фильтру. Запросы, в которых не указано значение «reports_timestamp», по умолчанию возвращают только последние отчеты. Укажите «reports_timestamp>=0», чтобы получить все данные отчета. Поддерживаемые поля фильтра: - orgUnitId
- серийный номер
- идентификатор устройства
- report_timestamp
Фильтр reports_timestamp принимает либо миллисекундный формат Unix Epoch, либо формат RFC3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр. Оба формата должны быть заключены в простые двойные кавычки. Примеры: «2014-10-02T15:01:23Z», «2014-10-02T15:01:23.045123456Z», «1679283943823». |
readMask | string ( FieldMask format) Необходимый. Прочитайте маску, чтобы указать, какие поля возвращать. Поддерживаемые пути readMask: - имя
- orgUnitId
- идентификатор устройства
- серийный номер
- cpuInfo
- cpuStatusReport
- ПамятьИнформация
- MemoryStatusReport
- информация о сети
- СетьДиагностикаОтчет
- сетьстатусрепорт
- осUpdateStatus
- графикаИнформация
- графикаStatusReport
- Информация о батарее
- Статус батареиОтчет
- Информация о хранилище
- StorageStatusReport
- ThunderboltИнформация
- аудиостатусрепорт
- bootPerformanceReport
- HeartbeatStatusReport
- отчет о пропускной способности сети
- периферийные устройстваОтчет
- киоскAppStatusReport
- приложениеReport
- отчет о времени выполненияСчетчики
Это разделенный запятыми список полных имен полей. Пример: "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
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-24 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`"]]
