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

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

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

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

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