Method: customers.telemetry.users.get
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/telemetry/users/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. השם של TelemetryUser להחזרה.
|
פרמטרים של שאילתה
| פרמטרים |
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"
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של TelemetryUser.
היקפי הרשאה
נדרש היקף הרשאות 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\u003eRetrieve detailed telemetry data for a specific user within your organization using the \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the user using the \u003ccode\u003ename\u003c/code\u003e path parameter and optionally filter the returned data with the \u003ccode\u003ereadMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a \u003ccode\u003eTelemetryUser\u003c/code\u003e object containing user details, device information, and various reports (audio status, device activity, network bandwidth, peripherals, and apps).\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint uses gRPC Transcoding for its URL structure.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.users.get\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGet telemetry user.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{name=customers/*/telemetry/users/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------|\n| `name` | `string` Required. Name of the `TelemetryUser` to return. |\n\n### Query parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [TelemetryUser](/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`"]]
