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)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "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)

פלט בלבד. דוחות סטטוס של מעבדים שנאספים מדי פעם וממוינים בסדר יורד של 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.
appReport[]

object (AppReport)

פלט בלבד. דוחות על אפליקציות שנאספים מדי פעם וממוינים בסדר יורד של 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

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

enum (Architecture)

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

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

integer

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

boolean

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

boolean

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

ארכיטקטורה

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

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

CpuStatusReport

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

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

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

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

integer

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

object (CpuTemperatureInfo)

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

CpuTemperatureInfo

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

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

integer

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

string

פלט בלבד. תווית של מעבד (CPU). דוגמה: Core 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

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

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

MemoryEncryptionAlgorithm

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

טיפוסים בני מנייה (enum)
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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

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

טיפוסים בני מנייה (enum)
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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

פלט בלבד. מזהה GUID של חיבור לרשת.
connectionState

enum (NetworkConnectionState)

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

enum (NetworkType)

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

NetworkType

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

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

NetworkDiagnosticsReport

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

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

UpdateState

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

טיפוסים בני מנייה (enum)
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 או לא.
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

פלט בלבד. מזהה יצרן בן שלוש אותיות.
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

פלט בלבד. קיבולת העיצוב (mAh).
designMinVoltage

integer

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

object (Date)

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

string

פלט בלבד. הטכנולוגיה של הסוללה. דוגמה: Li-ion

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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
serialNumber

string

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

object (BatterySampleReport)

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

enum (BatteryHealth)

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

string (int64 format)

פלט בלבד. קיבולת טעינה מלאה (mAh).
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

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

string (int64 format)

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

integer

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

integer

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

integer

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

string (int64 format)

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

string

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

BatteryHealth

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

  • הסטטוס הזה לא משמש למדידה או לציון של סוללה פגומה. הנוסחה לחישוב המדד הזה היא: קיבולת הטעינה המלאה הנוכחית חלקי הקיבולת שתכננו.
  • היצרן הוא זה שמגדיר את תקינות הסוללה ואת מדיניות האחריות.
טיפוסים בני מנייה (enum)
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

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

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

ThunderboltInfo

פרטי האוטובוס של Thunderbolt.

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

enum (ThunderboltSecurityLevel)

רמת האבטחה של ציר Thunderbolt.

ThunderboltSecurityLevel

רמת האבטחה של ציר Thunderbolt.

טיפוסים בני מנייה (enum)
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 וליציאת Display Port במעגן. כל הקישורים של 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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

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

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

string (Timestamp format)

חותמת הזמן של השבתה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

הסיבה לכיבוי.
reportTime

string (Timestamp format)

חותמת הזמן שבה הדוח נאסף.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

ShutdownReason

הסיבה לכיבוי.

טיפוסים בני מנייה (enum)
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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
state

enum (State)

מציין את המצב שאליו המכשיר השתנה

מדינה

מצב המכשיר

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

KioskAppStatusReport

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

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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)

חותמת הזמן שבה הדוח נאסף.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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.

Methods

get

 אחזור מכשיר טלמטריה.

list

 הצגת רשימה של כל מכשירי הטלמטריה.