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
המסנן 'timestamp' מקבל את הפורמט 'Unix Epoch אלפיות השנייה' או את RFC3339 UTC 'Zulu' ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. צריך להקיף את שני הפורמטים במירכאות כפולות פשוטות. דוגמאות: '2014-10-02T15:01:23Z', '2014-10-02T15:01:23.045123456Z', '1679283943823'.
readMask

string (FieldMask format)

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

הנתיבים הנתמכים של ReadMask הם:

  • מכשיר
  • user
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent

זוהי רשימה מופרדת בפסיקים של שמות מלאים של שדות. דוגמה: "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