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