REST Resource: customers.telemetry.devices

Tài nguyên: TelemetryDevice

Dữ liệu đo từ xa được thu thập từ một thiết bị được quản lý.

  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_DEVICE
Biểu diễn dưới dạng 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)
    }
  ]
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của thiết bị.
customer

string

Chỉ có đầu ra. Khách hàng Google Workspace có doanh nghiệp đã đăng ký thiết bị.
orgUnitId

string

Chỉ có đầu ra. Mã nhận dạng đơn vị tổ chức của thiết bị.
deviceId

string

Chỉ có đầu ra. Mã Directory API duy nhất của thiết bị. Giá trị này giống với mã Directory API của Bảng điều khiển dành cho quản trị viên trong thẻ Thiết bị ChromeOS
serialNumber

string

Chỉ có đầu ra. Số sê-ri của thiết bị. Giá trị này giống với Số sê-ri của Bảng điều khiển dành cho quản trị viên trong thẻ Thiết bị ChromeOS.
cpuInfo[]

object (CpuInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của CPU cho thiết bị.
cpuStatusReport[]

object (CpuStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái CPU được thu thập định kỳ, sắp xếp theo thứ tự giảm dần của reportTime.
memoryInfo

object (MemoryInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật bộ nhớ của thiết bị.
memoryStatusReport[]

object (MemoryStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái bộ nhớ được thu thập định kỳ, sắp xếp giảm dần theo reportTime.
networkInfo

object (NetworkInfo)

Chỉ có đầu ra. Thông tin về thiết bị mạng.
networkStatusReport[]

object (NetworkStatusReport)

Chỉ có đầu ra. Thông số mạng được thu thập định kỳ.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

Chỉ có đầu ra. Dữ liệu chẩn đoán mạng được thu thập định kỳ.
osUpdateStatus[]

object (OsUpdateStatus)

Chỉ có đầu ra. Chứa thông tin liên quan đến trạng thái cập nhật ChromeOS.
graphicsInfo

object (GraphicsInfo)

Chỉ có đầu ra. Chứa thông tin về các thiết bị ngoại vi đồ hoạ cho thiết bị.
graphicsStatusReport[]

object (GraphicsStatusReport)

Chỉ có đầu ra. Báo cáo đồ hoạ được thu thập định kỳ.
batteryInfo[]

object (BatteryInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật của pin trên thiết bị.
batteryStatusReport[]

object (BatteryStatusReport)

Chỉ có đầu ra. Báo cáo về pin được thu thập định kỳ.
storageInfo

object (StorageInfo)

Chỉ có đầu ra. Thông tin về thông số kỹ thuật bộ nhớ của thiết bị.
storageStatusReport[]

object (StorageStatusReport)

Chỉ có đầu ra. Báo cáo về bộ nhớ được thu thập định kỳ.
thunderboltInfo[]

object (ThunderboltInfo)

Chỉ có đầu ra. Thông tin về bus Thunderbolt.
audioStatusReport[]

object (AudioStatusReport)

Chỉ có đầu ra. Báo cáo âm thanh được thu thập định kỳ, sắp xếp theo thứ tự giảm dần của reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

Chỉ có đầu ra. Báo cáo hiệu suất khởi động của thiết bị.
heartbeatStatusReport[]

object (HeartbeatStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái nhịp tim chứa dấu thời gian được sắp xếp định kỳ theo thứ tự giảm dần của reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

Chỉ có đầu ra. Báo cáo trạng thái ứng dụng kiosk cho thiết bị kiosk
networkBandwidthReport[]

object (NetworkBandwidthReport)

Chỉ có đầu ra. Báo cáo băng thông mạng được thu thập định kỳ và sắp xếp theo thứ tự giảm dần của reportTime.
peripheralsReport[]

object (PeripheralsReport)

Chỉ có đầu ra. Báo cáo về các thiết bị ngoại vi được thu thập định kỳ và sắp xếp theo thứ tự giảm dần của reportTime.
appReport[]

object (AppReport)

Chỉ có đầu ra. Báo cáo ứng dụng được thu thập định kỳ và sắp xếp theo thứ tự giảm dần của reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

Chỉ có đầu ra. Báo cáo bộ đếm thời gian chạy thu thập thời gian chạy trong suốt vòng đời của thiết bị, cũng như số lượng các quá trình chuyển đổi S0->S3, S0->S4 và S0->S5, tức là chuyển sang trạng thái ngủ, ngủ đông và tắt nguồn

CpuInfo

Thông số kỹ thuật của CPU cho thiết bị

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền thật chi tiết: TELEMETRY_API_CPU_INFO
Biểu diễn dưới dạng JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
Trường
model

string

Chỉ có đầu ra. Tên mẫu CPU. Ví dụ: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
architecture

enum (Architecture)

Chỉ có đầu ra. Loại kiến trúc cho CPU.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
maxClockSpeed

integer

Chỉ có đầu ra. Tốc độ xung nhịp tối đa của CPU tính bằng kHz.
keylockerSupported

boolean

Chỉ có đầu ra. Khoá có được hỗ trợ hay không.
keylockerConfigured

boolean

Chỉ có đầu ra. Khoá có được định cấu hình hay không.TRUE = Đã bật; FALSE = Đã tắt. Chỉ được báo cáo nếu keylockerSupported = TRUE.

Kiến trúc

Loại kiến trúc cho CPU.

Enum
ARCHITECTURE_UNSPECIFIED Không rõ kiến trúc.
X64 Kiến trúc x64

CpuStatusReport

Cung cấp thông tin về trạng thái của CPU.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: 10 phút một lần
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_CPU_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tính bằng mili giây, biểu thị thời điểm báo cáo này được lấy mẫu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
cpuUtilizationPct

integer

Chỉ có đầu ra. Mẫu mức sử dụng CPU (0-100%).
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

Chỉ có đầu ra. Thông tin mẫu nhiệt độ CPU cho mỗi nhân CPU theo độ C

CpuTemperatureInfo

Nhiệt độ CPU của thiết bị. Được lấy mẫu trên mỗi lõi CPU theo độ C.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceCpuInfo
  • Tần suất thu thập dữ liệu: 10 phút một lần
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
Trường
temperatureCelsius

integer

Chỉ có đầu ra. Nhiệt độ CPU tính bằng độ C.
label

string

Chỉ có đầu ra. Nhãn CPU. Ví dụ: Lõi 0

MemoryInfo

Thông tin về bộ nhớ của thiết bị.

  • Trường này có cả thông tin đo từ xa và thông tin thiết bị:
    • totalRamBytes – Thông tin thiết bị
    • availableRamBytes – Thông tin đo từ xa
    • totalMemoryEncryption – Thông tin thiết bị
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu:
    • totalRamBytes – Chỉ khi tải lên
    • availableRamBytes – Mỗi 10 phút
    • totalMemoryEncryption – khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định:
    • totalRamBytes – 3 giờ
    • availableRamBytes – 3 giờ
    • totalMemoryEncryption – khi khởi động thiết bị
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không có mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng lần tiếp theo: chỉ dành cho totalMemoryEncryption
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_MEMORY_INFO
Biểu diễn dưới dạng JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
Trường
totalRamBytes

string (int64 format)

Chỉ có đầu ra. Tổng dung lượng RAM tính bằng byte.
availableRamBytes

string (int64 format)

Chỉ có đầu ra. Dung lượng RAM còn trống tính bằng byte.
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

Chỉ có đầu ra. Thông tin mã hoá tổng bộ nhớ cho thiết bị.

TotalMemoryEncryptionInfo

Thông tin mã hoá bộ nhớ của một thiết bị.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi thiết bị khởi động
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
Trường
encryptionState

enum (MemoryEncryptionState)

Trạng thái mã hoá bộ nhớ trên thiết bị.
maxKeys

string (int64 format)

Số lượng khoá tối đa có thể dùng để mã hoá.
keyLength

string (int64 format)

Độ dài của khoá mã hoá.
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

Thuật toán mã hoá bộ nhớ.

MemoryEncryptionState

Trạng thái mã hoá bộ nhớ trên thiết bị.

Enum
MEMORY_ENCRYPTION_STATE_UNSPECIFIED Trạng thái mã hoá bộ nhớ chưa được thiết lập.
MEMORY_ENCRYPTION_STATE_UNKNOWN Không xác định được trạng thái mã hoá bộ nhớ.
MEMORY_ENCRYPTION_STATE_DISABLED Tính năng mã hoá bộ nhớ trên thiết bị đang tắt.
MEMORY_ENCRYPTION_STATE_TME Tính năng mã hoá bộ nhớ trên thiết bị sử dụng công nghệ mã hoá tổng bộ nhớ.
MEMORY_ENCRYPTION_STATE_MKTME Tính năng mã hoá bộ nhớ trên thiết bị sử dụng phương thức mã hoá tổng bộ nhớ bằng nhiều khoá.

MemoryEncryptionAlgorithm

Thuật toán mã hoá đang được sử dụng trên thiết bị.

Enum
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED Chưa đặt thuật toán mã hoá bộ nhớ.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN Không xác định được thuật toán mã hoá bộ nhớ đang được sử dụng.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 Thuật toán mã hoá bộ nhớ đang dùng thuật toán mã hoá AES_XTS với thuật toán mã hoá theo khối 128 bit.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 Thuật toán mã hoá bộ nhớ đang sử dụng thuật toán mã hoá AES_XTS với một thuật toán mã hoá theo khối 256 bit.

MemoryStatusReport

Chứa các mẫu báo cáo trạng thái bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceMemoryInfo
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên, SystemRamFreeByes được thu thập sau mỗi 10 phút
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ một lần
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_MEMORY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tính bằng mili giây, biểu thị thời điểm báo cáo này được lấy mẫu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
systemRamFreeBytes

string (int64 format)

Chỉ có đầu ra. Lượng RAM trống tính bằng byte (không đáng tin cậy do Thu thập rác).
pageFaults

integer

Chỉ có đầu ra. Số lượng lỗi trên trang trong quá trình thu thập này

NetworkInfo

Thông tin về thiết bị mạng.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkDeviceConfiguration
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi thiết bị khởi động
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền thật chi tiết: TELEMETRY_API_NETWORK_INFO
Biểu diễn dưới dạng JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
Trường
networkDevices[]

object (NetworkDevice)

Chỉ có đầu ra. Danh sách thiết bị mạng.

NetworkDevice

Thông tin chi tiết về thiết bị mạng.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkDeviceConfiguration
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi thiết bị khởi động
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
Trường
type

enum (NetworkDeviceType)

Chỉ có đầu ra. Loại thiết bị mạng.
macAddress

string

Chỉ có đầu ra. Địa chỉ MAC (nếu có) của thiết bị mạng tương ứng.
meid

string

Chỉ có đầu ra. MEID (nếu có) của thiết bị mạng tương ứng.
imei

string

Chỉ có đầu ra. IMEI (nếu có) của thiết bị mạng tương ứng.
iccid

string

Chỉ có đầu ra. Mã nhận dạng thẻ mạch tích hợp được liên kết với thẻ SIM của thiết bị.
mdn

string

Chỉ có đầu ra. Số điện thoại di động được liên kết với thẻ SIM của thiết bị.

NetworkDeviceType

Các loại thiết bị mạng.

Enum
NETWORK_DEVICE_TYPE_UNSPECIFIED Chưa chỉ định loại thiết bị mạng.
CELLULAR_DEVICE Thiết bị di động.
ETHERNET_DEVICE Thiết bị Ethernet.
WIFI_DEVICE Thiết bị Wi-Fi.

NetworkStatusReport

Trạng thái của các mạng hiển thị/đã định cấu hình.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportNetworkStatus
  • Tần suất thu thập dữ liệu: 60 phút
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Có
  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng 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),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian báo cáo trạng thái mạng.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

Chỉ có đầu ra. Tần suất lấy mẫu báo cáo.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
signalStrengthDbm

integer

Chỉ có đầu ra. Cường độ tín hiệu của mạng không dây được đo bằng decibel.
lanIpAddress

string

Chỉ có đầu ra. Địa chỉ IP của mạng LAN.
gatewayIpAddress

string

Chỉ có đầu ra. Địa chỉ IP của cổng.
transmissionBitRateMbps

string (int64 format)

Chỉ có đầu ra. Tốc độ bit truyền được đo bằng Megabit/giây.
receivingBitRateMbps

string (int64 format)

Chỉ có đầu ra. Tốc độ bit nhận được đo bằng Megabit/giây.
transmissionPowerDbm

integer

Chỉ có đầu ra. Công suất truyền được đo bằng đê-xi-ben.
encryptionOn

boolean

Chỉ có đầu ra. Khoá mã hoá Wi-Fi có bị tắt hay không.
wifiPowerManagementEnabled

boolean

Chỉ có đầu ra. Đã bật tính năng quản lý nguồn Wi-Fi
guid

string

Chỉ có đầu ra. Mã GUID của kết nối mạng.
connectionState

enum (NetworkConnectionState)

Chỉ có đầu ra. Trạng thái kết nối hiện tại của mạng.
connectionType

enum (NetworkType)

Chỉ có đầu ra. Loại kết nối mạng.
ipv6Address[]

string

Chỉ có đầu ra. Địa chỉ IPv6 được chỉ định cho mạng này (nếu có). Mỗi địa chỉ là một chuỗi trong biểu thị văn bản IPv6 tiêu chuẩn (ví dụ: "2001:db8::1").
gatewayIpv6Address

string

Chỉ có đầu ra. IPv6 của cổng cho giao diện này (nếu phát hiện được)
metered

boolean

Chỉ có đầu ra. Mạng có được phát hiện là mạng đo lượng dữ liệu hay không.

NetworkType

Các loại kết nối mạng.

Enum
NETWORK_TYPE_UNSPECIFIED Chưa xác định loại kết nối mạng
CELLULAR Kết nối mạng di động.
ETHERNET Kết nối mạng Ethernet.
TETHER Chia sẻ kết nối mạng.
VPN Kết nối mạng riêng ảo (VPN).
WIFI Kết nối mạng Wi-Fi.

NetworkDiagnosticsReport

Kết quả kiểm thử mạng để xác định trạng thái kết nối mạng của thiết bị, ví dụ: độ trễ HTTPS cao hay bình thường.

  • Cần có quyền chi tiết: TELEMETRY_API_NETWORK_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm thu thập dữ liệu chẩn đoán.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

Chỉ có đầu ra. Dữ liệu kiểm thử độ trễ HTTPS.

OsUpdateStatus

Chứa thông tin về trạng thái cập nhật hệ điều hành hiện tại.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceOsUpdateStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_OS_REPORT
Biểu diễn dưới dạng JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
Trường
updateState

enum (UpdateState)

Chỉ có đầu ra. Trạng thái hiện tại của bản cập nhật hệ điều hành.
newPlatformVersion

string

Chỉ có đầu ra. Phiên bản nền tảng mới của hình ảnh hệ điều hành đang được tải xuống và áp dụng. Tham số này chỉ được đặt khi trạng thái cập nhật là OS_IMAGE_DOWNLOAD_IN_PROGRESS hoặc OS_UPDATE_NEED_REBOOT. Lưu ý rằng đây có thể là "0.0.0.0" giả cho trạng thái OS_UPDATE_NEED_REBOOT trong một số trường hợp đặc biệt, ví dụ: công cụ cập nhật được khởi động lại mà không cần khởi động lại.
newRequestedPlatformVersion

string

Chỉ có đầu ra. Phiên bản nền tảng mới được yêu cầu từ ứng dụng kiosk đang chờ cập nhật.
lastUpdateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần cập nhật thành công gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần kiểm tra cập nhật gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần khởi động lại gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

UpdateState

Trạng thái cập nhật hệ điều hành

Enum
UPDATE_STATE_UNSPECIFIED Chưa chỉ định tiểu bang.
OS_IMAGE_DOWNLOAD_NOT_STARTED Hệ điều hành chưa bắt đầu tải xuống.
OS_IMAGE_DOWNLOAD_IN_PROGRESS Hệ điều hành đã bắt đầu tải xuống trên thiết bị.
OS_UPDATE_NEED_REBOOT Thiết bị cần khởi động lại để hoàn tất quá trình tải lên.

GraphicsInfo

Thông tin về hệ thống con đồ hoạ.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceGraphicsStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền thật chi tiết: TELEMETRY_API_GRAPHICS_INFO
Biểu diễn dưới dạng JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
Trường
adapterInfo

object (GraphicsAdapterInfo)

Chỉ có đầu ra. Thông tin về card đồ hoạ (GPU).
eprivacySupported

boolean

Chỉ có đầu ra. Màn hình ePrivacy có được hỗ trợ hay không.
displayDevices[]

object (DisplayDevice)

Chỉ có đầu ra. Thông tin về(các) màn hình của thiết bị.
touchScreenInfo

object (TouchScreenInfo)

Chỉ có đầu ra. Thông tin về(các) màn hình cảm ứng bên trong của thiết bị.

GraphicsAdapterInfo

Thông tin về một card đồ hoạ (GPU).

Biểu diễn dưới dạng JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
Trường
adapter

string

Chỉ có đầu ra. Tên bộ chuyển đổi. Ví dụ: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

Chỉ có đầu ra. Phiên bản trình điều khiển GPU.
deviceId

string (int64 format)

Chỉ có đầu ra. Biểu thị mã thiết bị của thẻ đồ hoạ.

DisplayDevice

Thông tin về thiết bị hiển thị.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
Trường
displayName

string

Chỉ có đầu ra. Hiển thị tên thiết bị.
displayWidthMm

integer

Chỉ có đầu ra. Chiều rộng màn hình (tính bằng milimet).
displayHeightMm

integer

Chỉ có đầu ra. Chiều cao màn hình tính bằng milimet.
internal

boolean

Chỉ có đầu ra. Màn hình có phải là màn hình nội bộ hay không.
manufacturerId

string

Chỉ có đầu ra. Mã nhận dạng nhà sản xuất gồm 3 chữ cái.
modelId

integer

Chỉ có đầu ra. Mã sản phẩm của nhà sản xuất.
manufactureYear

integer

Chỉ có đầu ra. Năm sản xuất.
serialNumber

integer

Chỉ có đầu ra. Số sê-ri.
edidVersion

string

Chỉ có đầu ra. Phiên bản EDID.

TouchScreenInfo

Thông tin về màn hình cảm ứng của thiết bị.

Biểu diễn dưới dạng JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
Trường
touchpadLibrary

string

Chỉ có đầu ra. Tên thư viện bàn di chuột mà ngăn xếp đầu vào sử dụng.
devices[]

object (TouchScreenDevice)

Chỉ có đầu ra. Danh sách các thiết bị có màn hình cảm ứng nội bộ.

TouchScreenDevice

Thông tin về một thiết bị có màn hình cảm ứng bên trong.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của thiết bị có màn hình cảm ứng.
touchPointCount

integer

Chỉ có đầu ra. Số lượng điểm chạm được hỗ trợ trên thiết bị.
stylusCapable

boolean

Chỉ có đầu ra. Thiết bị có màn hình cảm ứng có hỗ trợ bút cảm ứng hay không.

GraphicsStatusReport

Thông tin về hệ thống con đồ hoạ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceGraphicsInfo
  • Tần suất thu thập dữ liệu: 3 giờ.
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_GRAPHICS_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian báo cáo dữ liệu đồ hoạ.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

Chỉ có đầu ra. Thông tin về màn hình của thiết bị.

DisplayInfo

Thông tin cho một màn hình.

Biểu diễn dưới dạng JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
Trường
deviceId

string (int64 format)

Chỉ có đầu ra. Biểu thị mã thiết bị của thẻ đồ hoạ.
resolutionWidth

integer

Chỉ có đầu ra. Chiều rộng độ phân giải tính bằng pixel.
resolutionHeight

integer

Chỉ có đầu ra. Chiều cao độ phân giải tính bằng pixel.
refreshRate

integer

Chỉ có đầu ra. Tốc độ làm mới tính bằng Hz.
isInternal

boolean

Chỉ có đầu ra. Cho biết màn hình có phải là màn hình nội bộ hay không.
displayName

string

Chỉ có đầu ra. Hiển thị tên thiết bị.
serialNumber

integer

Chỉ có đầu ra. Số sê-ri.
edidVersion

string

Chỉ có đầu ra. Phiên bản EDID.

BatteryInfo

Thông tin về pin.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_BATTERY_INFO
Biểu diễn dưới dạng JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
Trường
serialNumber

string

Chỉ có đầu ra. Số sê-ri của pin.
manufacturer

string

Chỉ có đầu ra. Nhà sản xuất pin.
designCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng pin thiết kế (mAmpere-giờ).
designMinVoltage

integer

Chỉ có đầu ra. Điện áp đầu ra tối thiểu được thiết kế (mV)
manufactureDate

object (Date)

Chỉ có đầu ra. Ngày sản xuất pin.
technology

string

Chỉ có đầu ra. Công nghệ của pin. Ví dụ: Li-ion

BatteryStatusReport

Dữ liệu trạng thái của pin.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_BATTERY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm mẫu được thu thập trên thiết bị

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
serialNumber

string

Chỉ có đầu ra. Số sê-ri của pin.
sample[]

object (BatterySampleReport)

Chỉ có đầu ra. Lấy mẫu dữ liệu cho pin được sắp xếp theo thứ tự giảm dần của reportTime.
batteryHealth

enum (BatteryHealth)

Chỉ có đầu ra. Tình trạng pin.
fullChargeCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng khi sạc đầy (giờ-miliampe).
cycleCount

integer

Chỉ có đầu ra. Số chu kỳ.

BatterySampleReport

Lấy mẫu dữ liệu về pin.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDevicePowerStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm mẫu được thu thập trên thiết bị

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

Chỉ có đầu ra. Điện áp pin (milivolt).
remainingCapacity

string (int64 format)

Chỉ có đầu ra. Dung lượng pin còn lại (mAmpere-giờ).
temperature

integer

Chỉ có đầu ra. Nhiệt độ tính bằng độ C.
dischargeRate

integer

Chỉ có đầu ra. Tốc độ xả pin được đo bằng mW. Dương nếu pin đang xả, âm nếu pin đang sạc.
chargeRate

integer

Chỉ có đầu ra. Phần trăm pin.
current

string (int64 format)

Chỉ có đầu ra. Dòng điện của pin (mA).
status

string

Chỉ có đầu ra. Trạng thái pin được đọc từ sysfs. Ví dụ: Xả

BatteryHealth

Biểu thị tình trạng hiện tại của pin.

  • Trạng thái này không phải là thước đo hoặc dấu hiệu cho thấy pin bị lỗi. Tỷ lệ này được tính bằng cách chia dung lượng sạc đầy hiện tại cho dung lượng thiết kế.
  • Nhà sản xuất có trách nhiệm xác định tính toàn vẹn của pin và chính sách bảo hành.
Enum
BATTERY_HEALTH_UNSPECIFIED Không xác định được tình trạng.
BATTERY_HEALTH_NORMAL Pin ở trạng thái tốt, mức sạc tối đa / mức sạc tối đa theo thiết kế > 80%
BATTERY_REPLACE_SOON Pin ở trạng thái không tốt vừa phải và bạn nên sớm thay pin, dung lượng sạc đầy / dung lượng thiết kế từ 75% đến 80%
BATTERY_REPLACE_NOW Pin không ở trong tình trạng tốt và bạn nên thay pin, dung lượng sạc đầy / dung lượng thiết kế < 75%

StorageInfo

Dữ liệu trạng thái cho bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceStorageStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_STORAGE_INFO
Biểu diễn dưới dạng JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
Trường
volume[]

object (DiskVolume)

Thông tin về ổ đĩa
availableDiskBytes

string (int64 format)

Dung lượng còn trống để lưu trữ dữ liệu người dùng trên thiết bị tính bằng byte.
totalDiskBytes

string (int64 format)

Tổng dung lượng bộ nhớ dành cho dữ liệu người dùng trên thiết bị tính bằng byte.

DiskVolume

Thông tin về ổ đĩa

Biểu diễn dưới dạng JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
Trường
volumeId

string

Mã ổ đĩa.
storageFreeBytes

string (int64 format)

Dung lượng lưu trữ trống tính bằng byte.
storageTotalBytes

string (int64 format)

Tổng dung lượng lưu trữ tính bằng byte.

StorageStatusReport

Dữ liệu trạng thái cho bộ nhớ.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceStorageStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_STORAGE_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
Trường
reportTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm mẫu được thu thập trên thiết bị

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

Chỉ có đầu ra. Báo cáo trên đĩa.

DiskInfo

Trạng thái của một thiết bị lưu trữ.

Biểu diễn dưới dạng 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
}
Trường
serialNumber

string

Chỉ có đầu ra. Số sê-ri của ổ đĩa.
manufacturer

string

Chỉ có đầu ra. Nhà sản xuất ổ đĩa.
model

string

Chỉ có đầu ra. Mẫu ổ đĩa.
sizeBytes

string (int64 format)

Chỉ có đầu ra. Dung lượng ổ đĩa.
type

string

Chỉ có đầu ra. Loại ổ đĩa: eMMC / NVMe / ATA / SCSI.
health

string

Chỉ có đầu ra. Tình trạng ổ đĩa.
volumeIds[]

string

Chỉ có đầu ra. Số lượng ổ đĩa.
bytesReadThisSession

string (int64 format)

Chỉ có đầu ra. Số byte đã đọc kể từ lần khởi động gần đây nhất.
bytesWrittenThisSession

string (int64 format)

Chỉ có đầu ra. Số byte đã ghi kể từ lần khởi động gần đây nhất.
readTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian đọc dữ liệu từ ổ đĩa kể từ lần khởi động gần đây nhất.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
writeTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian ghi vào ổ đĩa kể từ lần khởi động gần đây nhất.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
ioTimeThisSession

string (Duration format)

Chỉ có đầu ra. Tính thời gian ổ đĩa và hàng đợi bận, vì vậy, không giống như các trường ở trên, các yêu cầu song song không được tính nhiều lần.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
discardTimeThisSession

string (Duration format)

Chỉ có đầu ra. Thời gian đã dùng để loại bỏ kể từ lần khởi động gần đây nhất. Loại bỏ là ghi vào các khối trống không còn được sử dụng. Được hỗ trợ trên các nhân 4.18 trở lên.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

ThunderboltInfo

Thông tin về hệ thống bus Thunderbolt.

  • Trường này cung cấp thông tin về thiết bị, là thông tin tĩnh và sẽ không thay đổi theo thời gian.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceSecurityStatus
  • Tần suất thu thập dữ liệu: Khi khởi động thiết bị
  • Tần suất báo cáo dữ liệu mặc định: Khi thiết bị khởi động
    • Được kiểm soát theo chính sách: Không
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền thật chi tiết: TELEMETRY_API_BUS_DEVICE_INFO
Biểu diễn dưới dạng JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
Trường
securityLevel

enum (ThunderboltSecurityLevel)

Mức độ bảo mật của bus Thunderbolt.

ThunderboltSecurityLevel

Mức độ bảo mật của bus Thunderbolt.

Enum
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED Bạn chưa đặt mức an ninh Thunderbolt.
THUNDERBOLT_SECURITY_NONE_LEVEL Tất cả thiết bị đều được phần mềm tự động kết nối. Không cần người dùng phê duyệt.
THUNDERBOLT_SECURITY_USER_LEVEL Người dùng được hỏi xem có cho phép kết nối thiết bị hay không.
THUNDERBOLT_SECURITY_SECURE_LEVEL Người dùng được hỏi xem có cho phép kết nối thiết bị hay không. Ngoài ra, thiết bị sẽ nhận được một thử thách phải khớp với thử thách dự kiến dựa trên một khoá ngẫu nhiên được ghi vào thuộc tính sysfs khoá
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL Phần mềm này tự động tạo các đường hầm cho Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL Phần mềm cố định sẽ tự động tạo các đường hầm cho bộ điều khiển USB và Cổng hiển thị trong đế cắm. Tất cả các đường liên kết PCIe ở hạ lưu của đế cắm đều bị xoá.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL Tính năng tạo đường hầm PCIE bị tắt.

BootPerformanceReport

Báo cáo hiệu suất khởi động của thiết bị.

  • Trường này là thông tin đo từ xa và sẽ thay đổi theo thời gian khi thiết bị được sử dụng.
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceBootMode
  • Tần suất thu thập dữ liệu: Trong mỗi sự kiện khởi động
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Có
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_OS_REPORT
Biểu diễn dưới dạng JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
Trường
bootUpDuration

string (Duration format)

Tổng thời gian khởi động.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
bootUpTime

string (Timestamp format)

Dấu thời gian khi nguồn điện được bật.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

Tổng thời gian từ khi bắt đầu tắt cho đến khi tắt nguồn.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
shutdownTime

string (Timestamp format)

Dấu thời gian khi tắt.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

Lý do tắt máy.
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm thu thập báo cáo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

ShutdownReason

Lý do tắt máy.

Enum
SHUTDOWN_REASON_UNSPECIFIED Không chỉ định lý do tắt máy.
USER_REQUEST Do người dùng yêu cầu.
SYSTEM_UPDATE Đã bắt đầu cập nhật hệ thống.
LOW_BATTERY Tắt do pin yếu.
OTHER Tắt do các lý do khác.

HeartbeatStatusReport

Báo cáo trạng thái nhịp tim của một thiết bị.

  • Có sẵn cho Kiosk
  • Trường này cung cấp trạng thái trực tuyến/ngoại tuyến/không xác định của một thiết bị và sẽ chỉ được đưa vào nếu trạng thái đã thay đổi (ví dụ: Trực tuyến -> Ngoại tuyến)
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: HeartbeatEnabled Thông tin khác
  • Tần suất nhịp tim: 2 phút
    • Lưu ý: Nếu thiết bị chuyển sang trạng thái ngoại tuyến, có thể mất tối đa 12 phút thì trạng thái trực tuyến của thiết bị mới được cập nhật
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo vào lần tiếp theo thiết bị kết nối mạng: Không áp dụng
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền chi tiết: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "state": enum (State)
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm phát hiện thấy trạng thái thay đổi

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
state

enum (State)

Trạng thái mà thiết bị đã chuyển sang

Tiểu bang

Trạng thái thiết bị

Enum
STATE_UNSPECIFIED Chưa chỉ định tiểu bang
UNKNOWN Thiết bị không đủ điều kiện để theo dõi nhịp tim
ONLINE Thiết bị có kết nối mạng
OFFLINE Thiết bị hiện không có kết nối mạng
DEVICE_OUTDATED Thiết bị đã lỗi thời

KioskAppStatusReport

Báo cáo trạng thái ứng dụng Kiosk của một thiết bị.

  • Có sẵn cho Kiosk
  • Trường này cung cấp mã ứng dụng và số phiên bản đang chạy trên thiết bị kiosk, cũng như dấu thời gian của lần cập nhật báo cáo gần đây nhất
  • Dữ liệu cho trường này được kiểm soát thông qua chính sách: ReportDeviceSessionStatus
  • Tần suất thu thập dữ liệu: Chỉ khi tải lên
  • Tần suất báo cáo dữ liệu mặc định: 3 giờ
    • Do chính sách kiểm soát: Có
  • Bộ nhớ đệm: Nếu thiết bị không kết nối mạng, dữ liệu đã thu thập sẽ được lưu trữ cục bộ và sẽ được báo cáo khi thiết bị kết nối mạng vào lần tiếp theo: Không
  • Chỉ báo cáo cho người dùng liên kết: Không áp dụng
  • Cần có quyền ở cấp độ chi tiết: TELEMETRY_API_APPS_REPORT
Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm thu thập báo cáo

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
appId

string

Mã ứng dụng của ứng dụng kiosk, ví dụ: "mdmkkicfmmkgmpkmkdikhlbggogpicma"
appVersion

string

Số phiên bản ứng dụng của ứng dụng kiosk, ví dụ: "1.10.118"

RuntimeCountersReport

Bộ đếm thời gian chạy được truy xuất từ CPU. Hiện tại, chỉ Intel vPro PSR trên Gen 14 trở lên mới hỗ trợ số liệu đo từ xa về bộ đếm thời gian chạy.

Biểu diễn dưới dạng JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
Trường
reportTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm thu thập báo cáo.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

Tổng thời gian chạy trong vòng đời. Hiện tại, luôn là thời gian chạy S0 từ Intel vPro PSR.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
enterSleepCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái ngủ. Hiện tại, được lấy thông qua PSR, tính từ S0->S3.
enterHibernationCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái ngủ đông. Hiện được lấy thông qua PSR, tính từ S0->S4.
enterPoweroffCount

string (int64 format)

Số lần thiết bị chuyển sang trạng thái tắt nguồn. Hiện được lấy thông qua PSR, tính từ S0->S5.

Phương thức

get

 Nhận thiết bị đo từ xa.

list

 Liệt kê tất cả các thiết bị đo từ xa.