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
- serialNumber
- deviceId
- reports_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
- 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. Java הוא סימן מסחרי רשום של חברת 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`"]]
