Method: customers.telemetry.events.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
parent |
string
必須。お客様 ID または「my_customer」リクエストを発行したアカウントに関連付けられているお客様を使用します。
|
クエリ パラメータ
| パラメータ |
filter |
string
省略可。フィルタに一致するリソースのみを含めます。このパラメータは現在省略可能ですが、このパラメータは必須です。イベントタイプを 1 つ以上指定してください。 サポートされているフィルタ フィールド: - deviceId
- userId
- deviceOrgUnitId
- userOrgUnitId
- timestamp
- eventType
「timestamp」フィルタでは、Unix エポックミリ秒形式または RFC3339 UTC「Zulu」のいずれかを使用できます。最大 9 桁の小数点以下 9 桁でサポートされます。どちらの形式も単純な二重引用符で囲む必要があります。例: 「2014-10-02T15:01:23Z」、「2014-10-02T15:01:23.045123456Z」、「1679283943823」
|
readMask |
string (FieldMask format)
必須。返されるフィールドを指定するリードマスク。このフィールドは現在必須ですが、省略可能になります。一方、イベントタイプのフィルタ パラメータは必須になります。 サポートされている readMask パスは次のとおりです。 - デバイス
- ユーザー
- audioSevereUnderrunEvent
- usbPeripheralsEvent
- httpsLatencyChangeEvent
- networkStateChangeEvent
- wifiSignalStrengthEvent
- vpnConnectionStateChangeEvent
- appInstallEvent
- appUninstallEvent
- appLaunchEvent
- osCrashEvent
完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
|
pageSize |
integer
省略可。返される結果の最大数。デフォルト値は 100 です。最大値は 1,000 です。
|
pageToken |
string
省略可。リストの次のページを指定するためのトークン。
|
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
お客様のテレメトリー イベントを一覧表示するレスポンス メッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
{
"telemetryEvents": [
{
object (TelemetryEvent)
}
],
"nextPageToken": string
} |
| フィールド |
telemetryEvents[] |
object (TelemetryEvent)
レスポンスで返されるテレメトリー イベント。
|
nextPageToken |
string
リストの次のページを指定するためのトークン。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eList telemetry events for a specific customer using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by device, user, organizational unit, timestamp, or event type using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eSpecify desired fields in the response using the \u003ccode\u003ereadMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of telemetry events and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.events.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.ListTelemetryEventsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList telemetry events.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events`\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. Although this parameter is currently optional, this parameter will be required- please specify at least 1 event type. Supported filter fields: - deviceId - userId - deviceOrgUnitId - userOrgUnitId - timestamp - eventType The \"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. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported readMask paths are: - device - user - audioSevereUnderrunEvent - usbPeripheralsEvent - httpsLatencyChangeEvent - networkStateChangeEvent - wifiSignalStrengthEvent - vpnConnectionStateChangeEvent - appInstallEvent - appUninstallEvent - appLaunchEvent - osCrashEvent \u003cbr /\u003e This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `pageSize` | `integer` Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000. |\n| `pageToken` | `string` Optional. 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 events for a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"telemetryEvents\": [ { object (/chrome/management/reference/rest/v1/customers.telemetry.events#TelemetryEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `telemetryEvents[]` | `object (`[TelemetryEvent](/chrome/management/reference/rest/v1/customers.telemetry.events#TelemetryEvent)`)` Telemetry events 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`"]]
