Method: customers.telemetry.events.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการเหตุการณ์การส่งข้อมูลทางไกล
คำขอ HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
parent |
string
ต้องระบุ รหัสลูกค้าหรือ "my_customer" ให้ใช้ลูกค้าที่เชื่อมโยงกับบัญชีที่ส่งคำขอ
|
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
filter |
string
ไม่บังคับ รวมเฉพาะทรัพยากรที่ตรงกับตัวกรองเท่านั้น แม้ว่าปัจจุบันพารามิเตอร์นี้จะไม่บังคับ แต่ต้องระบุพารามิเตอร์นี้ โปรดระบุอย่างน้อย 1 ประเภทเหตุการณ์ ช่องตัวกรองที่รองรับ: - deviceId
- userId
- deviceOrgUnitId
- userOrgUnitId
- การประทับเวลา
- eventType
"การประทับเวลา" ตัวกรองจะยอมรับรูปแบบ Unix Epoch ในหน่วยมิลลิวินาที หรือ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ทั้ง 2 รูปแบบควรล้อมรอบด้วยเครื่องหมายคําพูดคู่แบบง่าย เช่น "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`"]]
