Method: customers.telemetry.users.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle Nutzer der Telemetrie auf.
HTTP-Anfrage
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Kundennummer oder „my_customer“, um den Kunden zu verwenden, der mit dem Konto verknüpft ist, über das die Anfrage erfolgt.
|
Abfrageparameter
| Parameter |
filter |
string
Fügen Sie nur Ressourcen hinzu, die dem Filter entsprechen. Unterstützte Filterfelder:
|
readMask |
string (FieldMask format)
Lesemaske, mit der angegeben wird, welche Felder zurückgegeben werden sollen. Folgende Pfade für readMask werden unterstützt: - 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
Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
|
pageSize |
integer
Maximale Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 100. Der Höchstwert ist 1.000.
|
pageToken |
string
Token, um die nächste Seite in der Liste anzugeben.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht zum Auflisten von Telemetrienutzern für einen Kunden.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"telemetryUsers": [
{
object (TelemetryUser)
}
],
"nextPageToken": string
} |
| Felder |
telemetryUsers[] |
object (TelemetryUser)
In der Antwort zurückgegebene Nutzer mit Telemetriedaten.
|
nextPageToken |
string
Token, um die nächste Seite in der Liste anzugeben.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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`"]]
