Method: customers.telemetry.devices.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수 항목입니다. 고객 ID 또는 'my_customer' 요청한 계정과 연결된 고객을 사용합니다.
|
쿼리 매개변수
| 매개변수 |
filter |
string
선택사항입니다. 필터와 일치하는 리소스만 포함합니다. 'reports_timestamp'를 지정하지 않는 요청 값은 기본적으로 최근 보고서만 반환합니다. 'reports_timestamp>=0'을 지정합니다. 클릭하여 모든 보고서 데이터를 가져옵니다. 지원되는 필터 필드: - orgUnitId
- serialNumber
- deviceId
- reports_timestamp
'reports_timestamp' 필터는 Unix 에포크 밀리초 형식 또는 RFC3339 UTC 'Zulu'를 허용합니다. 나노초 해상도 및 최대 9자리 소수 자릿수의 형식으로 구성됩니다. 두 형식 모두 간단한 큰따옴표로 묶어야 합니다. 예: '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입니다. 최댓값은 1,000입니다.
|
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 Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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`"]]
