Method: customers.telemetry.events.list

הצגת רשימה של אירועי טלמטריה.

בקשת HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. מספר לקוח או 'my_customer' כדי להשתמש בלקוח שמשויך לחשבון שממנו נשלחה הבקשה.

פרמטרים של שאילתה

פרמטרים
filter

string

זה שינוי אופציונלי. יש לכלול רק משאבים שתואמים למסנן. הפרמטר הזה אופציונלי כרגע, אבל הוא יהיה חובה. יש לציין סוג אירוע אחד לפחות.

שדות סינון נתמכים:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • חותמת זמן
  • eventType
ה"חותמת זמן" המסנן מקבל בפורמט Unix Epoch אלפיות השנייה או בפורמט RFC3339 UTC "Zulu" בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. צריך להקיף את שני הפורמטים במירכאות כפולות פשוטות. דוגמאות: '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