Method: customers.telemetry.events.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
رویدادهای تله متری را فهرست کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. شناسه مشتری یا "my_customer" برای استفاده از مشتری مرتبط با حساب درخواست کننده. |
پارامترهای پرس و جو
| پارامترها |
|---|
filter | string اختیاری. فقط منابعی را بگنجانید که با فیلتر مطابقت دارند. اگرچه این پارامتر در حال حاضر اختیاری است، این پارامتر مورد نیاز خواهد بود - لطفا حداقل 1 نوع رویداد را مشخص کنید. فیلدهای فیلتر پشتیبانی شده: - شناسه دستگاه
- شناسه کاربر
- deviceOrgUnitId
- userOrgUnitId
- مهر زمانی
- رویداد نوع
فیلتر «مهر زمانی» قالب میلی‌ثانیه‌ای Unix Epoch یا قالب RFC3339 UTC «Zulu» را با وضوح نانوثانیه و حداکثر نه رقم کسری می‌پذیرد. هر دو قالب باید با نقل قول های دوتایی ساده احاطه شوند. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، "1679283943823". |
readMask | string ( FieldMask format) مورد نیاز. ماسک را بخوانید تا مشخص کنید کدام فیلدها را بازگردانید. اگرچه در حال حاضر مورد نیاز است، این فیلد اختیاری خواهد شد، در حالی که پارامتر فیلتر با نوع رویداد ضروری خواهد بود. مسیرهای ReadMask پشتیبانی شده عبارتند از: - دستگاه
- کاربر
- audioSevereUnderrunEvent
- usbPeripheralsEvent
- https LatencyChangeEvent
- networkStateChangeEvent
- wifiSignalStrengthEvent
- vpnConnectionStateChangeEvent
- appInstallEvent
- appUninstallEvent
- appLaunchEvent
- osCrashEvent
این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
pageSize | integer اختیاری. حداکثر تعداد نتایج برای بازگشت. مقدار پیش فرض 100 است. حداکثر مقدار 1000 است. |
pageToken | string اختیاری. رمزی برای تعیین صفحه بعدی در لیست. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای فهرست کردن رویدادهای تله متری برای مشتری.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"telemetryEvents": [
{
object (TelemetryEvent)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
telemetryEvents[] | object ( TelemetryEvent ) رویدادهای تله متری در پاسخ بازگشتند. |
nextPageToken | string رمزی برای تعیین صفحه بعدی در لیست. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
