REST Resource: customers.telemetry.devices

משאב: TelemetryDevice

נתוני טלמטריה שנאספו ממכשיר מנוהל.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE
ייצוג JSON 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
שדות
name

string

פלט בלבד. שם המשאב של המכשיר.
customer

string

פלט בלבד. לקוח Google Workspace שהארגון שלו רשם את המכשיר.
orgUnitId

string

פלט בלבד. מזהה היחידה הארגונית של המכשיר.
deviceId

string

פלט בלבד. המזהה הייחודי של ה-Directory API של המכשיר. הערך הזה זהה למזהה ב-Directory API של מסוף Admin בכרטיסייה 'מכשירי ChromeOS'
serialNumber

string

פלט בלבד. המספר הסידורי של המכשיר. הערך הזה זהה למספר הסידורי של מסוף Admin בכרטיסייה 'מכשירי ChromeOS'.
cpuInfo[]

object (CpuInfo)

פלט בלבד. מידע על מפרטי המעבד (CPU) של המכשיר.
cpuStatusReport[]

object (CpuStatusReport)

פלט בלבד. דוחות סטטוס המעבד (CPU) שנאספו מדי פעם ממוינים בסדר יורד של reportTime.
memoryInfo

object (MemoryInfo)

פלט בלבד. מידע בנוגע למפרטי הזיכרון של המכשיר.
memoryStatusReport[]

object (MemoryStatusReport)

פלט בלבד. דוחות סטטוס הזיכרון שנאספו מדי פעם ממוינים בירידה של reportTime.
networkInfo

object (NetworkInfo)

פלט בלבד. מידע על מכשירי הרשת.
networkStatusReport[]

object (NetworkStatusReport)

פלט בלבד. מפרטי רשתות נאספים מדי פעם.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

פלט בלבד. ניתוחים של הרשת נאספים מדי פעם.
osUpdateStatus[]

object (OsUpdateStatus)

פלט בלבד. מכיל מידע רלוונטי בנוגע לסטטוס העדכון של ChromeOS.
graphicsInfo

object (GraphicsInfo)

פלט בלבד. מכיל מידע בנוגע לציוד ההיקפי של המכשיר.
graphicsStatusReport[]

object (GraphicsStatusReport)

פלט בלבד. דוחות גרפיים שנאספים מעת לעת.
batteryInfo[]

object (BatteryInfo)

פלט בלבד. מידע על מפרטי הסוללה של המכשיר.
batteryStatusReport[]

object (BatteryStatusReport)

פלט בלבד. דוחות הסוללה נאספים מדי פעם.
storageInfo

object (StorageInfo)

פלט בלבד. מידע על מפרטי האחסון של המכשיר.
storageStatusReport[]

object (StorageStatusReport)

פלט בלבד. דוחות אחסון שנאספים מדי פעם.
thunderboltInfo[]

object (ThunderboltInfo)

פלט בלבד. מידע על אוטובוס Thunderbolt.
audioStatusReport[]

object (AudioStatusReport)

פלט בלבד. דוחות אודיו שנאספים מדי פעם ממוינים בסדר יורד של reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

פלט בלבד. הפעלת דוחות הביצועים של המכשיר.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

פלט בלבד. דוח של סטטוס פעימת הלב שמכיל חותמות זמן, שממוינות מדי פעם בסדר יורד של reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

פלט בלבד. דוח סטטוס של אפליקציית "קיוסק" למכשיר הקיוסק
networkBandwidthReport[]

object (NetworkBandwidthReport)

פלט בלבד. דוחות על רוחב פס ברשת שנאספו מדי פעם ממוינים בסדר יורד של reportTime.
peripheralsReport[]

object (PeripheralsReport)

פלט בלבד. דוחות על ציוד היקפי שנאספים מדי פעם ממוינים בסדר יורד של reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

פלט בלבד. בדוחות על מוני זמן ריצה נאספו נתונים של זמן הריצה לכל משך החיים של המכשיר, וגם את המספרים של מעברי S0->S3, S0->S4, ו-S0->S5, שמשמעותם כניסה למצב שינה, תרדמה וכיבוי

CpuInfo

מפרט המעבד (CPU) של המכשיר

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_CPU_INFO
ייצוג JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
שדות
model

string

פלט בלבד. שם הדגם של המעבד (CPU). דוגמה: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
architecture

enum (Architecture)

פלט בלבד. סוג הארכיטקטורה של המעבד (CPU).

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

integer

פלט בלבד. מהירות השעון המקסימלית של המעבד (CPU) ב-kHz.
keylockerSupported

boolean

פלט בלבד. האם יש תמיכה ב-Keylocker.
keylockerConfigured

boolean

פלט בלבד. האם נעילת המקשים מוגדרת.TRUE = מופעלת; FALSE = מושבתת. מדווח רק אם keylockerSupported = TRUE.

ארכיטקטורה

סוג הארכיטקטורה של המעבד (CPU).

טיפוסים בני מנייה (enums)
ARCHITECTURE_UNSPECIFIED ארכיטקטורה לא ידועה.
X64 ארכיטקטורת x64

CpuStatusReport

מספק מידע על הסטטוס של המעבד (CPU).

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: כל 10 דקות
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_CPU_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן באלפיות השנייה שמייצגת את הזמן שבו הדוח נדגם.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

פלט בלבד. תדירות הדגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
cpuUtilizationPct

integer

פלט בלבד. דגימה של ניצול המעבד (CPU) (0-100 אחוזים).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

פלט בלבד. מידע על דגימת הטמפרטורה של המעבד (CPU) לכל ליבת מעבד (CPU) בצלזיוס

CpuTemperatureInfo

הטמפרטורה של המעבד (CPU) במכשיר. נדגמת לכל ליבת מעבד (CPU) בצלזיוס.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceCpuInfo
  • תדירות איסוף הנתונים: כל 10 דקות
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
ייצוג JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
שדות
temperatureCelsius

integer

פלט בלבד. הטמפרטורה של המעבד (CPU) בצלזיוס.
label

string

פלט בלבד. תווית של המעבד (CPU). דוגמה: ליבה 0

MemoryInfo

פרטי הזיכרון של המכשיר.

  • בשדה הזה מופיעים גם טלמטריה וגם מידע מהמכשירים:
    • totalRamBytes – פרטי המכשיר
    • availableRamBytes – פרטי טלמטריה
    • totalMemoryEncryption – פרטי המכשיר
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים:
    • totalRamBytes - רק בזמן ההעלאה
    • availableRamBytes – כל 10 דקות
    • totalMemoryEncryption - בהפעלת המכשיר
  • תדירות ברירת המחדל של דיווח נתונים:
    • totalRamBytes עד 3 שעות
    • availableRamBytes עד 3 שעות
    • totalMemoryEncryption - בהפעלת המכשיר
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: רק עבור totalMemoryEncryption.
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_MEMORY_INFO
ייצוג JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
שדות
totalRamBytes

string (int64 format)

פלט בלבד. סה"כ RAM בבייטים.
availableRamBytes

string (int64 format)

פלט בלבד. נפח ה-RAM הזמין בבייטים.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

פלט בלבד. המידע הכולל על הצפנת הזיכרון של המכשיר.

TotalMemoryEncryptionInfo

פרטים על הצפנת הזיכרון של המכשיר.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל לדיווח על נתונים: בהפעלת המכשיר
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא זמין
ייצוג JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
שדות
encryptionState

enum (MemoryEncryptionState)

המצב של הצפנת הזיכרון במכשיר.
maxKeys

string (int64 format)

המספר המקסימלי של מפתחות שניתן להשתמש בהם להצפנה.
keyLength

string (int64 format)

האורך של מפתחות ההצפנה.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

האלגוריתם של הצפנת הזיכרון.

MemoryEncryptionState

המצב של הצפנת הזיכרון במכשיר.

טיפוסים בני מנייה (enums)
MEMORY_ENCRYPTION_STATE_UNSPECIFIED לא הוגדר מצב הצפנת זיכרון.
MEMORY_ENCRYPTION_STATE_UNKNOWN מצב הצפנת הזיכרון לא ידוע.
MEMORY_ENCRYPTION_STATE_DISABLED הצפנת הזיכרון במכשיר מושבתת.
MEMORY_ENCRYPTION_STATE_TME בהצפנת הזיכרון במכשיר נעשה שימוש בהצפנת זיכרון כוללת.
MEMORY_ENCRYPTION_STATE_MKTME בהצפנת הזיכרון במכשיר נעשה שימוש בהצפנת זיכרון כולל של מספר מפתחות.

MemoryEncryptionAlgorithm

אלגוריתם ההצפנה שבו נעשה שימוש במכשיר.

טיפוסים בני מנייה (enums)
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED לא הוגדר אלגוריתם להצפנת זיכרון.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN אלגוריתם הצפנת הזיכרון שבו נעשה שימוש אינו ידוע.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 האלגוריתם להצפנת הזיכרון משתמש באלגוריתם ההצפנה AES_XTS עם מקודד בלוקים של 128 סיביות.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 האלגוריתם להצפנת הזיכרון משתמש באלגוריתם ההצפנה AES_XTS עם מקודד בלוקים של 256 סיביות.

MemoryStatusReport

מכיל דוגמאות של דוחות סטטוס זיכרון.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceMemoryInfo
  • תדירות איסוף הנתונים: רק בזמן ההעלאה, המערכת אוספת את SystemRamFreeByes כל 10 דקות
  • תדירות ברירת המחדל של דיווח נתונים: כל 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_MEMORY_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן באלפיות השנייה שמייצגת את הזמן שבו הדוח נדגם.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

פלט בלבד. תדירות הדגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
systemRamFreeBytes

string (int64 format)

פלט בלבד. כמות ה-RAM בחינם בבייטים (לא אמין עקב איסוף אשפה).
pageFaults

integer

פלט בלבד. מספר שגיאות דפים במהלך האוסף הזה

NetworkInfo

מידע על מכשיר הרשת.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportNetworkDeviceConfiguration
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל לדיווח על נתונים: בהפעלת המכשיר
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_INFO
ייצוג JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
שדות
networkDevices[]

object (NetworkDevice)

פלט בלבד. רשימה של מכשירי רשת.

NetworkDevice

פרטים על המכשיר ברשת.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportNetworkDeviceConfiguration
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל לדיווח על נתונים: בהפעלת המכשיר
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא זמין
ייצוג JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
שדות
type

enum (NetworkDeviceType)

פלט בלבד. סוג מכשיר הרשת.
macAddress

string

פלט בלבד. כתובת ה-MAC (אם רלוונטי) של מכשיר הרשת המתאים.
meid

string

פלט בלבד. MEID (אם רלוונטי) של מכשיר הרשת המתאים.
imei

string

פלט בלבד. מספר ה-IMEI (אם רלוונטי) של מכשיר הרשת המתאים.
iccid

string

פלט בלבד. מזהה כרטיס המעגל המשולב שמשויך לכרטיס ה-SIM של המכשיר.
mdn

string

פלט בלבד. מספר הספרייה של המכשיר הנייד המשויך לכרטיס ה-SIM של המכשיר.

NetworkDeviceType

סוגים של מכשירי רשת.

טיפוסים בני מנייה (enums)
NETWORK_DEVICE_TYPE_UNSPECIFIED לא צוין סוג של מכשיר רשת.
CELLULAR_DEVICE מכשיר סלולרי.
ETHERNET_DEVICE מכשיר אתרנט.
WIFI_DEVICE מכשיר Wi-Fi.

NetworkStatusReport

מצב הרשתות הגלויות/מוגדרות.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportNetworkStatus
  • תדירות איסוף הנתונים: 60 דקות
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • הועבר דיווח למשתמשים משויכים בלבד: כן
  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType)
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. השעה שבה מצב הרשת דווח.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
sampleFrequency

string (Duration format)

פלט בלבד. תדירות הדגימה של הדוח.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
signalStrengthDbm

integer

פלט בלבד. עוצמת האות של רשתות אלחוטיות שנמדדת בדציבלים.
lanIpAddress

string

פלט בלבד. כתובת IP ברשת LAN.
gatewayIpAddress

string

פלט בלבד. כתובת ה-IP של השער.
transmissionBitRateMbps

string (int64 format)

פלט בלבד. קצב העברת הנתונים של השידור נמדד במגה-ביט לשנייה.
receivingBitRateMbps

string (int64 format)

פלט בלבד. קבלת קצב העברת נתונים במגה-ביט לשנייה.
transmissionPowerDbm

integer

פלט בלבד. עוצמת ההעברה נמדדת בדציבלים.
encryptionOn

boolean

פלט בלבד. האם מפתח ההצפנה של ה-Wi-Fi כבוי.
wifiPowerManagementEnabled

boolean

פלט בלבד. ניהול צריכת החשמל של רשת ה-Wi-Fi מופעל
guid

string

פלט בלבד. הנחיות לחיבור לרשת.
connectionState

enum (NetworkConnectionState)

פלט בלבד. מצב החיבור הנוכחי לרשת.
connectionType

enum (NetworkType)

פלט בלבד. סוג החיבור לרשת.

NetworkType

סוגי החיבור לרשת.

טיפוסים בני מנייה (enums)
NETWORK_TYPE_UNSPECIFIED לא צוין סוג חיבור לרשת
CELLULAR חיבור לרשת סלולרית.
ETHERNET חיבור לרשת אתרנט.
TETHER שיתוף אינטרנט בין מכשירים (tethering)
VPN חיבור לרשת VPN.
WIFI חיבור לרשת Wi-Fi.

NetworkDiagnosticsReport

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

  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד האיסוף של האבחון.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
httpsLatencyData

object (HttpsLatencyRoutineData)

פלט בלבד. נתוני בדיקת זמן אחזור של HTTPS.

OsUpdateStatus

מכיל מידע בנוגע לסטטוס העדכון הנוכחי של מערכת ההפעלה.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceOsUpdateStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_OS_REPORT
ייצוג JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
שדות
updateState

enum (UpdateState)

פלט בלבד. המצב הנוכחי של עדכון מערכת ההפעלה.
newPlatformVersion

string

פלט בלבד. גרסת פלטפורמה חדשה של קובץ האימג' של מערכת ההפעלה שאתם מורידים ומחילים. היא מוגדרת רק כשסטטוס העדכון הוא OS_IMAGE_DOWNLOAD_IN_PROGRESS או OS_UPDATE_NEED_REBOOT. לתשומת ליבך, זו יכולה להיות '0.0.0.0' דמה בסטטוס OS_UPDATE_NEED_REBOOT בחלק מהמקרים של קצה. לדוגמה, מנוע העדכון מופעל מחדש ללא אתחול.
newRequestedPlatformVersion

string

פלט בלבד. גרסת פלטפורמה חדשה המבוקשת מאפליקציית "קיוסק" המעודכנת שבהמתנה.
lastUpdateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון המוצלח האחרון.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastUpdateCheckTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
lastRebootTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של ההפעלה מחדש האחרונה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

UpdateState

המצב של עדכון מערכת ההפעלה

טיפוסים בני מנייה (enums)
UPDATE_STATE_UNSPECIFIED לא צוין מצב.
OS_IMAGE_DOWNLOAD_NOT_STARTED ההורדה של מערכת ההפעלה לא התחילה.
OS_IMAGE_DOWNLOAD_IN_PROGRESS מערכת ההפעלה התחילה בהורדה למכשיר.
OS_UPDATE_NEED_REBOOT יש להפעיל מחדש את המכשיר כדי לסיים את ההעלאה.

GraphicsInfo

מידע על מערכת המשנה של הגרפיקה.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceGraphicsStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_GRAPHICS_INFO
ייצוג JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
שדות
adapterInfo

object (GraphicsAdapterInfo)

פלט בלבד. מידע על מתאם הגרפיקה (GPU).
eprivacySupported

boolean

פלט בלבד. האם יש תמיכה ב-ePrivacy Screen או לא.
displayDevices[]

object (DisplayDevice)

פלט בלבד. מידע על המסכים של המכשיר.
touchScreenInfo

object (TouchScreenInfo)

פלט בלבד. מידע על מסכי המגע הפנימיים של המכשיר.

GraphicsAdapterInfo

מידע על מתאם גרפי (GPU).

ייצוג JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
שדות
adapter

string

פלט בלבד. שם המתאם. דוגמה: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

פלט בלבד. גרסה של מנהל ההתקן של יחידת ה-GPU.
deviceId

string (int64 format)

פלט בלבד. מייצג את מזהה המכשיר של הכרטיס הגרפי.

DisplayDevice

מידע על המסך.

ייצוג JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer
}
שדות
displayName

string

פלט בלבד. הצגת שם המכשיר.
displayWidthMm

integer

פלט בלבד. רוחב התצוגה במילימטרים.
displayHeightMm

integer

פלט בלבד. הצגת הגובה במילימטרים.
internal

boolean

פלט בלבד. האם התצוגה היא פנימית או לא.
manufacturerId

string

פלט בלבד. מזהה יצרן בן 3 אותיות.
modelId

integer

פלט בלבד. קוד המוצר של היצרן.
manufactureYear

integer

פלט בלבד. שנת ייצור.

TouchScreenInfo

מידע במסך המגע של המכשיר.

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

string

פלט בלבד. שם הספרייה של לוח המגע המשמש את ערימת הקלט.
devices[]

object (TouchScreenDevice)

פלט בלבד. רשימה של המכשירים הפנימיים עם מסך המגע.

TouchScreenDevice

מידע על מכשיר פנימי עם מסך מגע.

ייצוג JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
שדות
displayName

string

פלט בלבד. השם המוצג של המכשיר עם מסך המגע.
touchPointCount

integer

פלט בלבד. מספר נקודות המגע הנתמכות במכשיר.
stylusCapable

boolean

פלט בלבד. אפשר להשתמש בסטיילוס במכשיר עם מסך מגע או לא.

GraphicsStatusReport

מידע על מערכת המשנה של הגרפיקה.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: ReportDeviceGraphicsInfo
  • תדירות איסוף הנתונים: 3 שעות.
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_GRAPHICS_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. השעה שבה דווחו נתוני הגרפיקה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
displays[]

object (DisplayInfo)

פלט בלבד. מידע על המסכים של המכשיר.

DisplayInfo

מידע לגבי תצוגה.

ייצוג JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string
}
שדות
deviceId

string (int64 format)

פלט בלבד. מייצג את מזהה המכשיר של הכרטיס הגרפי.
resolutionWidth

integer

פלט בלבד. רוחב הרזולוציה בפיקסלים.
resolutionHeight

integer

פלט בלבד. גובה הרזולוציה בפיקסלים.
refreshRate

integer

פלט בלבד. קצב הרענון ב-Hz
isInternal

boolean

פלט בלבד. שדה זה מציין אם המסך הוא פנימי או לא.
displayName

string

פלט בלבד. הצגת שם המכשיר.

BatteryInfo

מידע על הסוללה.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_BATTERY_INFO
ייצוג JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
שדות
serialNumber

string

פלט בלבד. המספר הסידורי של הסוללה.
manufacturer

string

פלט בלבד. יצרן הסוללה.
designCapacity

string (int64 format)

פלט בלבד. קיבולת עיצוב (מילי-אמפר לשעה).
designMinVoltage

integer

פלט בלבד. מתח יציאה מינימלי (mV)
manufactureDate

object (Date)

פלט בלבד. תאריך ייצור הסוללה.
technology

string

פלט בלבד. טכנולוגיה של הסוללה. דוגמה: ליתיום-יון

BatteryStatusReport

נתוני סטטוס הסוללה.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_BATTERY_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
שדות
reportTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
serialNumber

string

פלט בלבד. המספר הסידורי של הסוללה.
sample[]

object (BatterySampleReport)

פלט בלבד. נתוני הדגימה של הסוללה ממוינים בסדר יורד של reportTime.
batteryHealth

enum (BatteryHealth)

פלט בלבד. תקינות הסוללה.
fullChargeCapacity

string (int64 format)

פלט בלבד. קיבולת טעינה מלאה (מיליאמפר לשעה).
cycleCount

integer

פלט בלבד. מספר מחזורי הטעינה.

BatterySampleReport

מתבצעת דגימת נתונים של הסוללה.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDevicePowerStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
ייצוג JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
שדות
reportTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
voltage

string (int64 format)

פלט בלבד. המתח של הסוללה (מילי-וולט).
remainingCapacity

string (int64 format)

פלט בלבד. קיבולת הסוללה שנותרה (מיליאמפר לשעה).
temperature

integer

פלט בלבד. הטמפרטורה במעלות צלזיוס.
dischargeRate

integer

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

integer

פלט בלבד. אחוז טעינת הסוללה.
current

string (int64 format)

פלט בלבד. זרם הסוללה (mA).
status

string

פלט בלבד. קריאת סטטוס הסוללה מ-sysfs. דוגמה: לא בטעינה

BatteryHealth

מייצג את התקינות הנוכחית של הסוללה.

  • הסטטוס הזה הוא לא מדד או אינדיקציה לגבי סוללה פגומה. כדי לחשב את המדד הזה, מחלקים את קיבולת הטעינה המלאה הנוכחית בקיבולת העיצוב.
  • היצרן קובע את תקינות הסוללה ואת מדיניות האחריות.
טיפוסים בני מנייה (enums)
BATTERY_HEALTH_UNSPECIFIED מצב בריאותי לא ידוע.
BATTERY_HEALTH_NORMAL הסוללה תקינה, קיבולת טעינה מלאה / קיבולת עיצוב גבוהה מ-80%
BATTERY_REPLACE_SOON הסוללה לא תקינה במידה בינונית ומציעה להחליף בקרוב, קיבולת טעינה מלאה / קיבולת עיצובית של 75% עד 80%
BATTERY_REPLACE_NOW הסוללה לא בריאה ומציעה להחליף אותה, קיבולת טעינה מלאה / קיבולת עיצוב נמוכה מ-75%

StorageInfo

נתוני סטטוס לאחסון.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceStorageStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_STORAGE_INFO
ייצוג JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
שדות
volume[]

object (DiskVolume)

מידע על נפחי אחסון בדיסקים
availableDiskBytes

string (int64 format)

השטח הזמין לאחסון נתוני משתמש במכשיר בבייטים.
totalDiskBytes

string (int64 format)

המקום הכולל בבייטים לאחסון נתוני המשתמש במכשיר.

DiskVolume

מידע על נפחי אחסון בדיסקים

ייצוג JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
שדות
volumeId

string

מזהה נפח דיסק
storageFreeBytes

string (int64 format)

שטח אחסון חינם בבייטים.
storageTotalBytes

string (int64 format)

נפח האחסון הכולל בבייטים.

StorageStatusReport

נתוני סטטוס לאחסון.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceStorageStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_STORAGE_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
שדות
reportTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
disk[]

object (DiskInfo)

פלט בלבד. דוחות בדיסק.

DiskInfo

הסטטוס של התקן האחסון היחיד.

ייצוג JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
שדות
serialNumber

string

פלט בלבד. המספר הסידורי של הדיסק.
manufacturer

string

פלט בלבד. יצרן הדיסקים.
model

string

פלט בלבד. דגם הדיסק.
sizeBytes

string (int64 format)

פלט בלבד. גודל הדיסק.
type

string

פלט בלבד. סוג הדיסק: eMMC / NVMe / ATA / SCSI.
health

string

פלט בלבד. תקינות הדיסק.
volumeIds[]

string

פלט בלבד. נפחי דיסקים.
bytesReadThisSession

string (int64 format)

פלט בלבד. מספר הבייטים שנקראו מאז האתחול האחרון.
bytesWrittenThisSession

string (int64 format)

פלט בלבד. מספר הבייטים שנכתבו מאז האתחול האחרון.
readTimeThisSession

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
writeTimeThisSession

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
ioTimeThisSession

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
discardTimeThisSession

string (Duration format)

פלט בלבד. הזמן שהוקדש למחיקה מאז האתחול האחרון. פעולת המחיקה כותבת כדי לנקות בלוקים שכבר לא בשימוש. נתמכת בליבה (kernels) מגרסה 4.18 ואילך.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".

ThunderboltInfo

מידע על אוטובוס Thunderbolt.

  • בשדה הזה מוצג מידע סטטי על המכשיר, ולא ישתנה עם הזמן.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceSecurityStatus
  • תדירות איסוף הנתונים: בהפעלת המכשיר
  • תדירות ברירת המחדל לדיווח על נתונים: בהפעלת המכשיר
    • נשלטת מדיניות: לא
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_BUS_DEVICE_INFO
ייצוג JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
שדות
securityLevel

enum (ThunderboltSecurityLevel)

רמת האבטחה של אוטובוס Thunderbolt.

ThunderboltSecurityLevel

רמת האבטחה של אוטובוס Thunderbolt.

טיפוסים בני מנייה (enums)
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED רמת האבטחה של Thunderbolt לא הוגדרה.
THUNDERBOLT_SECURITY_NONE_LEVEL כל המכשירים מחוברים באופן אוטומטי באמצעות הקושחה. לא נדרש אישור של המשתמש.
THUNDERBOLT_SECURITY_USER_LEVEL המשתמש נשאל אם אפשר לחבר את המכשיר.
THUNDERBOLT_SECURITY_SECURE_LEVEL המשתמש נשאל אם אפשר לחבר את המכשיר. בנוסף, נשלח למכשיר אתגר שעומד באתגר הצפוי על סמך מפתח אקראי שנכתב במאפיין sysfs של המפתח
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL הקושחה יוצרת מנהרות באופן אוטומטי ל-Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL הקושחה יוצרת באופן אוטומטי מנהרות לבקר ה-USB וליציאת התצוגה באביזר העגינה. כל קישורי PCIe במורד הזרם של אביזר העגינה מוסרים.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL מנהור PCIE מושבת.

BootPerformanceReport

דוח ביצועי הפעלה של מכשיר.

  • השדה הזה הוא נתוני טלמטריה, והוא ישתנה עם הזמן עם השימוש במכשיר.
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceBootMode
  • תדירות איסוף הנתונים: בכל אירוע אתחול
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: כן
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_OS_REPORT
ייצוג JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
שדות
bootUpDuration

string (Duration format)

זמן ההפעלה הכולל.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
bootUpTime

string (Timestamp format)

חותמת הזמן של ההפעלה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
shutdownDuration

string (Duration format)

הזמן הכולל מאז תחילת הכיבוי עד לכיבוי.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
shutdownTime

string (Timestamp format)

חותמת הזמן של הסגירה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
shutdownReason

enum (ShutdownReason)

סיבת ההשבתה.
reportTime

string (Timestamp format)

חותמת הזמן של מועד האיסוף של הדוח.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

ShutdownReason

סיבת ההשבתה.

טיפוסים בני מנייה (enums)
SHUTDOWN_REASON_UNSPECIFIED לא צוינה סיבה לכיבוי.
USER_REQUEST ביוזמת המשתמש.
SYSTEM_UPDATE עדכון המערכת הופעל.
LOW_BATTERY כיבוי עקב סוללה חלשה.
OTHER הושבת מסיבות אחרות.

HeartbeatStatusReport

דוח סטטוס פעימת הלב של מכשיר.

  • זמינות לקיוסקים
  • השדה הזה מספק את הסטטוס של מכשיר מסוים במצב אונליין/אופליין/לא ידוע. הוא ייכלל רק אם הסטטוס שלו השתנה (למשל: אונליין -> אופליין)
  • הנתונים בשדה הזה נקבעים באמצעות המדיניות: HeartbeatEnabled מידע נוסף
  • תדירות פעימות הלב: 2 דקות
    • הערה: אם מכשיר עובר למצב אופליין, תהליך העדכון של סטטוס האונליין של המכשיר יכול להימשך עד 12 דקות
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי, וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא זמין.
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "state": enum (State)
}
שדות
reportTime

string (Timestamp format)

חותמת הזמן של המועד שבו הסטטוס השתנה

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
state

enum (State)

מצב המכשיר השתנה

ארץ

מצב המכשיר

טיפוסים בני מנייה (enums)
STATE_UNSPECIFIED לא צוין מצב
UNKNOWN המכשיר לא עומד בדרישות למעקב אחר פעימות לב
ONLINE המכשיר מחובר לאינטרנט
OFFLINE המכשיר במצב אופליין

KioskAppStatusReport

דוח סטטוס של אפליקציית "קיוסק" של מכשיר.

  • זמינות לקיוסקים
  • בשדה הזה מוצגים מזהה האפליקציה ומספר הגרסה שפועלים במכשיר קיוסק, וגם חותמת הזמן של מועד העדכון האחרון של הדוח
  • הנתונים בשדה הזה נשלטים באמצעות המדיניות: ReportDeviceSessionStatus
  • תדירות איסוף הנתונים: רק בזמן ההעלאה
  • תדירות ברירת המחדל של דיווח נתונים: 3 שעות
    • בקרת מדיניות: כן
  • מטמון: אם המכשיר במצב אופליין, הנתונים שנאספו מאוחסנים באופן מקומי וידווחו בפעם הבאה שהמכשיר יהיה אונליין: לא
  • מדווח רק למשתמשים משויכים: לא זמין
  • נדרשת הרשאה מפורטת: TELEMETRY_API_APPS_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
שדות
reportTime

string (Timestamp format)

חותמת הזמן של מועד האיסוף של הדוח

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
appId

string

מזהה האפליקציה של אפליקציית "קיוסק", למשל "mdmkkicfmmkgmpkmkdikhlbggogpicma"
appVersion

string

מספר גרסת האפליקציה של אפליקציית "קיוסק", למשל "1.10.118"

RuntimeCountersReport

מוני זמן ריצה שאוחזרו מהמעבד (CPU). נכון לעכשיו, נתוני הטלמטריה של מוני זמן הריצה נתמכים רק ב-Intel vPro PSR בדור 14 ואילך.

ייצוג JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
שדות
reportTime

string (Timestamp format)

חותמת הזמן של מועד האיסוף של הדוח.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
uptimeRuntimeDuration

string (Duration format)

זמן ריצה כולל בכל משך החיים. נכון לעכשיו, זמן ריצה של S0 מ-Intel vPro PSR הוא תמיד.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
enterSleepCount

string (int64 format)

מספר הפעמים שהמכשיר נכנס למצב שינה. התוצאה היא כרגע דרך ה-PSR, המספר מ-S0 עד S3.
enterHibernationCount

string (int64 format)

מספר הפעמים שהמכשיר נכנס למצב תרדמת. התוצאה היא כרגע דרך ה-PSR, המספר מ-S0 עד S4.
enterPoweroffCount

string (int64 format)

מספר הפעמים שהמכשיר עבר למצב כיבוי. התוצאה היא כרגע דרך ה-PSR, המספר מ-S0 עד S5.

שיטות

get

 צריך להתקין מכשיר טלמטריה.

list

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