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 נתמכים הם:

  • שם
  • 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