Method: customers.telemetry.users.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימה של כל המשתמשים בטלמטריה.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
parent |
string
חובה. Customer id או 'my_customer' כדי להשתמש בלקוח שמשויך לחשבון שמבצע את הבקשה.
|
פרמטרים של שאילתה
| פרמטרים |
filter |
string
כוללים רק משאבים שתואמים למסנן. שדות מסנן נתמכים:
|
readMask |
string (FieldMask format)
קוראים את המסכה כדי לציין אילו שדות להחזיר. הנתיבים הנתמכים של readMask הם: - שם
- orgUnitId
- userId
- userEmail
- userDevice.device_id
- userDevice.audio_status_report
- userDevice.device_activity_report
- userDevice.network_bandwidth_report
- userDevice.peripherals_report
- userDevice.app_report
זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
|
pageSize |
integer
המספר המקסימלי של תוצאות להחזרה. ערך ברירת המחדל הוא 100. הערך המקסימלי הוא 1,000.
|
pageToken |
string
אסימון לציון הדף הבא ברשימה.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת תגובה עם רשימת משתמשי הטלמטרייה של לקוח.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"telemetryUsers": [
{
object (TelemetryUser)
}
],
"nextPageToken": string
} |
| שדות |
telemetryUsers[] |
object (TelemetryUser)
משתמשי טלמטריה שהוחזרו בתגובה.
|
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\u003eLists all telemetry users for a given customer with optional filtering, pagination, and field selection.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the \u003ccode\u003e/v1/{parent=customers/*}/telemetry/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty; the response includes a list of \u003ccode\u003eTelemetryUser\u003c/code\u003e objects and a token for pagination.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.users.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.ListTelemetryUsersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList all telemetry users.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users`\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` Only include resources that match the filter. Supported filter fields: - userId - userOrgUnitId \u003cbr /\u003e |\n| `readMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Read mask to specify which fields to return. Supported readMask paths are: - name - orgUnitId - userId - userEmail - userDevice.device_id - userDevice.audio_status_report - userDevice.device_activity_report - userDevice.network_bandwidth_report - userDevice.peripherals_report - userDevice.app_report \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\nResponse message for listing telemetry users for a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"telemetryUsers\": [ { object (/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `telemetryUsers[]` | `object (`[TelemetryUser](/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser)`)` Telemetry users 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`"]]
