Method: customers.telemetry.devices.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Tüm telemetri cihazlarını listeleyin.
HTTP isteği
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
parent |
string
Zorunlu. Müşteri kimliği veya "my_customer" istekte bulunan hesapla ilişkili müşteriyi kullanmalıdır.
|
Sorgu parametreleri
Parametreler |
filter |
string
İsteğe bağlı. Yalnızca filtreyle eşleşen kaynakları dahil edin. "reports_timestamp" belirtilmeyen istekler değerinin varsayılan olarak yalnızca en son raporları döndürmesi gerekir. "reports_timestamp>=0" değerini belirtin tüm rapor verilerini almak için Desteklenen filtre alanları: - orgUnitId
- serialNumber
- deviceId
- reports_timestamp
"reports_timestamp" filtresi, Unix Epoch milisaniye biçimini veya RFC3339 UTC "Zulu"yu kabul eder biçimi kullanabilirsiniz. Her iki biçim de basit çift tırnak içine alınmalıdır. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".
|
readMask |
string (FieldMask format)
Zorunlu. Döndürülecek alanları belirtmek için maskeyi okuyun. Desteklenen ReadMask yolları şunlardır: - ad
- 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
Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo" .
|
pageSize |
integer
Döndürülecek maksimum sonuç sayısı. Varsayılan değer 100'dür. Maksimum değer 1.000'dir.
|
pageToken |
string
Listede sonraki sayfayı belirtmek için kullanılan jeton.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"devices": [
{
object (TelemetryDevice )
}
],
"nextPageToken": string
} |
Alanlar |
devices[] |
object (TelemetryDevice )
Yanıtta döndürülen telemetri cihazları.
|
nextPageToken |
string
Listede sonraki sayfayı belirtmek için kullanılan jeton.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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`"]]