Method: customers.telemetry.devices.list

רשימה של כל מכשירי הטלמטריה.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
filter

string

זה שינוי אופציונלי. יש לכלול רק משאבים שתואמים למסנן. בקשות שלא מצוין בהן הערך reports_timestamp (חותמת זמן) כברירת מחדל, יוחזרו כברירת מחדל רק לדוחות שהתקבלו לאחרונה. מציינים 'reports_timestamp>=0' כדי לקבל את כל נתוני הדוח.

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

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
המסנן 'reports_timestamp' מקבל פורמט Unix Epoch אלפיות השנייה או פורמט RFC3339 UTC 'Zulu' ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. צריך להקיף את שני הפורמטים במירכאות כפולות פשוטות. דוגמאות: '2014-10-02T15:01:23Z', '2014-10-02T15:01:23.045123456Z', '1679283943823'.
readMask

string (FieldMask format)

חובה. יש לקרוא את המסכה כדי לציין אילו שדות להחזיר.

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

  • name
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

זוהי רשימה מופרדת בפסיקים של שמות מלאים של שדות. דוגמה: "user.displayName,photo"
pageSize

integer

המספר המקסימלי של תוצאות להחזרה. ערך ברירת המחדל הוא 100. הערך המקסימלי הוא 1,000.
pageToken

string

אסימון לציון הדף הבא ברשימה.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "devices": [
    {
      object (TelemetryDevice)
    }
  ],
  "nextPageToken": string
}
שדות
devices[]

object (TelemetryDevice)

מכשירי הטלמטריה שהוחזרו בתגובה.
nextPageToken

string

אסימון לציון הדף הבא ברשימה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly