Tài nguyên: ChromeOsDevice
Thiết bị Google Chrome chạy trên Chrome OS. Để biết thêm thông tin về các tác vụ API phổ biến, hãy xem Hướng dẫn dành cho nhà phát triển.
Biểu diễn dưới dạng JSON |
---|
{ "deviceId": string, "serialNumber": string, "status": string, "lastSync": string, "supportEndDate": string, "annotatedUser": string, "annotatedLocation": string, "notes": string, "model": string, "meid": string, "orderNumber": string, "willAutoRenew": boolean, "osVersion": string, "platformVersion": string, "firmwareVersion": string, "macAddress": string, "bootMode": string, "lastEnrollmentTime": string, "kind": string, "recentUsers": [ { "type": string, "email": string } ], "activeTimeRanges": [ { "activeTime": integer, "date": string } ], "ethernetMacAddress": string, "annotatedAssetId": string, "etag": string, "diskVolumeReports": [ { "volumeInfo": [ { "volumeId": string, "storageTotal": string, "storageFree": string } ] } ], "systemRamTotal": string, "cpuStatusReports": [ { "reportTime": string, "cpuUtilizationPercentageInfo": [ integer ], "cpuTemperatureInfo": [ { "temperature": integer, "label": string } ] } ], "cpuInfo": [ { "model": string, "architecture": string, "maxClockSpeedKhz": integer, "logicalCpus": [ { "maxScalingFrequencyKhz": integer, "currentScalingFrequencyKhz": integer, "idleDuration": string, "cStates": [ { "displayName": string, "sessionDuration": string } ] } ] } ], "deviceFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "systemRamFreeReports": [ { "reportTime": string, "systemRamFreeInfo": [ string ] } ], "lastKnownNetwork": [ { "ipAddress": string, "wanIpAddress": string } ], "autoUpdateExpiration": string, "ethernetMacAddress0": string, "dockMacAddress": string, "manufactureDate": string, "orgUnitPath": string, "tpmVersionInfo": { "family": string, "specLevel": string, "manufacturer": string, "tpmModel": string, "firmwareVersion": string, "vendorSpecific": string }, "screenshotFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "orgUnitId": string, "osUpdateStatus": { object ( |
Trường | |
---|---|
deviceId |
Mã nhận dạng duy nhất của thiết bị Chrome. |
serialNumber |
Số sê-ri của thiết bị Chrome đã nhập khi thiết bị được bật. 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ị Chrome OS. |
status |
Trạng thái của thiết bị. Các giá trị được chấp nhận là:
|
lastSync |
Ngày và giờ thiết bị được đồng bộ hoá gần đây nhất với chế độ cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây ở dạng |
supportEndDate |
Ngày cuối cùng mà thiết bị được hỗ trợ. Điều này chỉ áp dụng cho các thiết bị được mua trực tiếp từ Google. Giá trị ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây ở dạng |
annotatedUser |
Người dùng thiết bị như ghi chú của quản trị viên. Độ dài tối đa là 100 ký tự. Bạn có thể nhập các giá trị trống. |
annotatedLocation |
Địa chỉ hoặc vị trí của thiết bị như được ghi chú bởi quản trị viên. Độ dài tối đa là |
notes |
Ghi chú về thiết bị này do quản trị viên thêm. Bạn có thể tìm kiếm thuộc tính này bằng tham số |
model |
Thông tin về mẫu thiết bị. Nếu thiết bị không có thông tin này, thì thuộc tính này sẽ không được đưa vào phản hồi. |
meid |
Mã nhận dạng thiết bị di động (MEID) hoặc Mã nhận dạng thiết bị di động quốc tế (IMEI) của thẻ di động 3G trên thiết bị di động. MEID/IMEI thường được dùng khi thêm thiết bị vào gói dịch vụ trả sau của nhà mạng không dây. Nếu thiết bị không có thông tin này, thì thuộc tính này sẽ không được đưa vào phản hồi. Để biết thêm thông tin về cách xuất danh sách MEID/IMEI, hãy xem Hướng dẫn dành cho nhà phát triển. |
orderNumber |
Số đơn đặt hàng của thiết bị. Chỉ những thiết bị mua trực tiếp từ Google mới có mã đơn đặt hàng. |
willAutoRenew |
Xác định xem thiết bị có tự động gia hạn hỗ trợ sau ngày kết thúc hỗ trợ hay không. Đây là thuộc tính chỉ có thể đọc. |
osVersion |
Phiên bản hệ điều hành của thiết bị Chrome. |
platformVersion |
Phiên bản nền tảng của thiết bị Chrome. |
firmwareVersion |
Phiên bản chương trình cơ sở của thiết bị Chrome. |
macAddress |
Địa chỉ MAC không dây của thiết bị. Nếu thiết bị không có thông tin này thì thông tin này sẽ không có trong phản hồi. |
bootMode |
Chế độ khởi động cho thiết bị. Các giá trị có thể có là:
|
lastEnrollmentTime |
Ngày và giờ đăng ký thiết bị gần đây nhất. Giá trị ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây ở dạng |
kind |
Loại tài nguyên. Đối với tài nguyên Chromeosdevices, giá trị là |
recentUsers[] |
Danh sách người dùng thiết bị gần đây (theo thứ tự giảm dần) theo thời gian đăng nhập gần đây nhất. |
recentUsers[].type |
Loại người dùng. Các giá trị được chấp nhận là:
|
recentUsers[].email |
Địa chỉ email của người dùng. Trường này chỉ xuất hiện nếu loại người dùng là |
activeTimeRanges[] |
Danh sách khoảng thời gian hoạt động (Chỉ đọc). |
activeTimeRanges[].activeTime |
Thời lượng sử dụng tính bằng mili giây. |
activeTimeRanges[].date |
Ngày sử dụng. |
ethernetMacAddress |
Địa chỉ MAC của thiết bị trên giao diện mạng Ethernet. |
annotatedAssetId |
Giá trị nhận dạng tài sản như ghi chú của quản trị viên hoặc được chỉ định trong quá trình đăng ký. |
etag |
Thẻ ETag của tài nguyên. |
diskVolumeReports[] |
Báo cáo về dung lượng ổ đĩa và các thông tin khác về các ổ đĩa đã gắn/kết nối. |
diskVolumeReports[].volumeInfo[] |
Phương tiện ổ đĩa |
diskVolumeReports[].volumeInfo[].volumeId |
Mã âm lượng |
diskVolumeReports[].volumeInfo[].storageTotal |
Tổng dung lượng ổ đĩa [tính bằng byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Dung lượng ổ đĩa trống [tính bằng byte] |
systemRamTotal |
Tổng dung lượng RAM trên thiết bị tính bằng byte |
cpuStatusReports[] |
Báo cáo về mức sử dụng CPU và nhiệt độ (Chỉ có thể đọc) |
cpuStatusReports[].reportTime |
Ngày và giờ nhận được báo cáo. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Danh sách các mẫu nhiệt độ CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Nhiệt độ tính bằng độ C. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Nhãn CPU |
cpuInfo[] |
Thông tin về thông số kỹ thuật của CPU trong thiết bị. |
cpuInfo[].model |
Tên mẫu CPU. |
cpuInfo[].architecture |
Cấu trúc CPU. |
cpuInfo[].maxClockSpeedKhz |
Tốc độ xung nhịp CPU tối đa tính bằng kHz. |
cpuInfo[].logicalCpus[] |
Thông tin về CPU logic |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Tần suất tối đa mà CPU được phép chạy theo chính sách. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Tần suất hiện tại của CPU. |
cpuInfo[].logicalCpus[].idleDuration |
Thời gian không hoạt động kể từ lần khởi động gần đây nhất. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
cpuInfo[].logicalCpus[].cStates[] |
Trạng thái C cho biết trạng thái tiêu thụ điện năng của CPU. Để biết thêm thông tin, hãy xem tài liệu do nhà sản xuất CPU xuất bản. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Tên tiểu bang. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Thời gian ở trạng thái kể từ lần khởi động lại gần đây nhất. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
deviceFiles[] |
Danh sách các tệp trên thiết bị cần tải xuống (Chỉ đọc) |
deviceFiles[].name |
Tên tệp |
deviceFiles[].type |
Loại tệp |
deviceFiles[].downloadUrl |
URL tải tệp xuống |
deviceFiles[].createTime |
Ngày và giờ tạo tệp |
systemRamFreeReports[] |
Báo cáo về dung lượng bộ nhớ RAM còn trống (Chỉ đọc) |
systemRamFreeReports[].reportTime |
Ngày và giờ nhận được báo cáo. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Chứa mạng đã biết gần đây nhất (Chỉ đọc) |
lastKnownNetwork[].ipAddress |
Địa chỉ IP. |
lastKnownNetwork[].wanIpAddress |
Địa chỉ IP của mạng WAN. |
autoUpdateExpiration |
(Chỉ có thể đọc) Dấu thời gian mà sau đó thiết bị sẽ ngừng nhận được các bản cập nhật hoặc tính năng hỗ trợ của Chrome |
ethernetMacAddress0 |
(Chỉ có thể đọc) Địa chỉ MAC được sử dụng bởi cổng Ethernet nội bộ của Chromebook và cho giao diện mạng tích hợp (ethernet). Định dạng là mười hai (12) chữ số thập lục phân mà không có bất kỳ dấu phân tách nào (chữ hoa). Điều này chỉ phù hợp với một số thiết bị. |
dockMacAddress |
(Chỉ có thể đọc) Địa chỉ MAC tích hợp sẵn cho đế sạc mà thiết bị đã kết nối. Trạng thái ban đầu thiết lập địa chỉ kiểm soát quyền truy cập vào nội dung nghe nhìn (địa chỉ MAC) được chỉ định để một đế sử dụng. Mã này dành riêng cho chính sách thiết bị chuyển qua MAC. Định dạng là mười hai (12) chữ số thập lục phân mà không có bất kỳ dấu phân tách nào (chữ hoa). Điều này chỉ phù hợp với một số thiết bị. |
manufactureDate |
(Chỉ có thể đọc) Ngày sản xuất thiết bị ở định dạng yyyy-mm-dd. |
orgUnitPath |
Đường dẫn đầy đủ của tổ chức mẹ có tên của đơn vị tổ chức được liên kết với thiết bị. Tên đường dẫn không phân biệt chữ hoa chữ thường. Nếu đơn vị tổ chức mẹ là tổ chức cấp cao nhất, thì đơn vị tổ chức đó sẽ được biểu thị bằng dấu gạch chéo lên, |
tpmVersionInfo |
Mô-đun nền tảng đáng tin cậy (TPM) (Chỉ đọc) |
tpmVersionInfo.family |
Nhóm TPM (Mô-đun nền tảng đáng tin cậy). Chúng tôi sử dụng mã hoá kiểu TPM 2.0, ví dụ: |
tpmVersionInfo.specLevel |
Mức thông số kỹ thuật của TPM (Mô-đun nền tảng đáng tin cậy). Xem Thông số kỹ thuật của thư viện cho TPM 2.0 và Thông số kỹ thuật chính cho TPM 1.2. |
tpmVersionInfo.manufacturer |
Mã nhà sản xuất TPM. |
tpmVersionInfo.tpmModel |
Số kiểu máy TPM. |
tpmVersionInfo.firmwareVersion |
Phiên bản chương trình cơ sở TPM. |
tpmVersionInfo.vendorSpecific |
Thông tin cụ thể của nhà cung cấp, chẳng hạn như mã nhà cung cấp. |
screenshotFiles[] |
Danh sách các tệp ảnh chụp màn hình để tải xuống. Loại luôn là "SCREENSHOT_FILE". (Chỉ đọc) |
screenshotFiles[].name |
Tên tệp |
screenshotFiles[].type |
Loại tệp |
screenshotFiles[].downloadUrl |
URL tải tệp xuống |
screenshotFiles[].createTime |
Ngày và giờ tạo tệp |
orgUnitId |
Mã nhận dạng duy nhất của đơn vị tổ chức. orgUnitPath là phiên bản orgUnitId mà con người có thể đọc được. Mặc dù orgUnitPath có thể thay đổi bằng cách đổi tên một đơn vị tổ chức trong đường dẫn, nhưng bạn không thể thay đổi orgUnitId đối với một đơn vị tổ chức. Bạn có thể cập nhật thuộc tính này bằng API. Để biết thêm thông tin về cách tạo cơ cấu tổ chức cho thiết bị của bạn, hãy xem trung tâm trợ giúp quản trị. |
osUpdateStatus |
Trạng thái của bản cập nhật hệ điều hành cho thiết bị. |
firstEnrollmentTime |
Ngày và giờ của lần đầu tiên đăng ký thiết bị. |
lastDeprovisionTimestamp |
(Chỉ có thể đọc) Ngày và giờ của lần huỷ cấp phép thiết bị gần đây nhất. |
deprovisionReason |
(Chỉ đọc) Lý do huỷ cấp phép. |
deviceLicenseType |
Chỉ có đầu ra. Loại giấy phép của thiết bị. |
backlightInfo[] |
Chỉ có đầu ra. Chứa thông tin về đèn nền cho thiết bị. |
OsUpdateStatus
Chứa thông tin về trạng thái hiện tại của bản cập nhật hệ điều hành.
Biểu diễn dưới dạng JSON |
---|
{
"state": enum ( |
Trường | |
---|---|
state |
Trạng thái cập nhật của một bản cập nhật hệ điều hành. |
targetOsVersion |
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. Chỉ thiết lập khi trạng thái cập nhật là UPDATE_STATUS_TẢI XUỐNG_IN_PROGRESS hoặc UPDATE_STATUS_NEED_REBOOT. Lưu ý rằng đây có thể là "0.0.0.0" giả cho UPDATE_STATUS_NEED_REBOOT đối với một số trường hợp hiếm gặp, 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. |
targetKioskAppVersion |
Phiên bản nền tảng mới và bắt buộc từ ứng dụng kiosk đang chờ cập nhật. |
updateTime |
Ngày và giờ cập nhật hệ điều hành thành công gần đây nhất. |
updateCheckTime |
Ngày và giờ của lần kiểm tra bản cập nhật gần đây nhất. |
rebootTime |
Ngày và giờ của lần khởi động lại gần đây nhất. |
UpdateState
Trạng thái cập nhật của một bản cập nhật hệ điều hành.
Enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Chưa chỉ định trạng thái cập nhật. |
UPDATE_STATE_NOT_STARTED |
Có một bản cập nhật đang chờ xử lý nhưng chưa bắt đầu. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Đang tải bản cập nhật đang chờ xử lý xuống. |
UPDATE_STATE_NEED_REBOOT |
Thiết bị đã sẵn sàng cài đặt bản cập nhật, nhưng phải khởi động lại. |
DeprovisionReason
Lý do huỷ cấp phép một thiết bị ChromeOS.
Enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Không xác định được lý do huỷ cấp phép. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Thay thế bằng kiểu máy tương tự. Bạn được uỷ quyền trả lại hàng hoá (RMA) hoặc bạn sắp thay thế một thiết bị hư hỏng còn trong thời gian bảo hành bằng mẫu thiết bị giống hệt. |
DEPROVISION_REASON_UPGRADE |
Thiết bị đã được nâng cấp. |
DEPROVISION_REASON_DOMAIN_MOVE |
Miền của thiết bị đã thay đổi. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Dịch vụ đối với thiết bị đã hết hạn. |
DEPROVISION_REASON_OTHER |
Thiết bị đã bị huỷ cấp phép vì một lý do cũ không còn được hỗ trợ. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Thay thế kiểu máy khác. Bạn sắp thay thế thiết bị này bằng một mẫu thiết bị đã nâng cấp hoặc mới hơn. |
DEPROVISION_REASON_RETIRING_DEVICE |
Ngừng sử dụng hệ thống thiết bị. Bạn sắp quyên góp, huỷ hoặc ngừng sử dụng thiết bị. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Chuyển bản nâng cấp ChromeOS Flex. Đây là thiết bị ChromeOS Flex mà bạn sẽ thay thế bằng Chromebook trong vòng một năm. |
DEPROVISION_REASON_NOT_REQUIRED |
Không yêu cầu lý do. Ví dụ: các giấy phép được trả về nhóm giấy phép của khách hàng. |
DEPROVISION_REASON_REPAIR_CENTER |
Trung tâm dịch vụ sửa chữa đã huỷ cấp phép thiết bị này. Chỉ Trung tâm dịch vụ sửa chữa mới có thể thiết lập trong quá trình RMA. |
DeviceLicenseType
Loại giấy phép của thiết bị này.
Enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Loại giấy phép này không xác định. |
ENTERPRISE |
Thiết bị đi kèm Bản nâng cấp Chrome Enterprise vĩnh viễn. |
ENTERPRISE_UPGRADE |
Thiết bị có Bản nâng cấp Chrome Enterprise độc lập hằng năm. |
EDUCATION_UPGRADE |
Thiết bị có Bản nâng cấp Chrome Education độc lập vĩnh viễn. |
EDUCATION |
Thiết bị đi kèm Bản nâng cấp Chrome Education vĩnh viễn. |
KIOSK_UPGRADE |
Thiết bị này có Bản nâng cấp Kiosk hằng năm. |
BacklightInfo
Thông tin về đèn nền của thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Trường | |
---|---|
path |
Chỉ có đầu ra. Đường dẫn đến đèn nền này trên hệ thống. Hữu ích nếu phương thức gọi cần tương quan với thông tin khác. |
maxBrightness |
Chỉ có đầu ra. Độ sáng tối đa cho đèn nền. |
brightness |
Chỉ có đầu ra. Độ sáng hiện tại của đèn nền, từ 0 đến tối đa Độ sáng. |
Phương thức |
|
---|---|
(deprecated) |
Thay vào đó, hãy sử dụng BatchChangeChromeOsDeviceStatus. |
|
Truy xuất các thuộc tính của thiết bị ChromeOS. |
|
Truy xuất danh sách các thiết bị ChromeOS được phân trang trong một tài khoản. |
|
Di chuyển hoặc chèn nhiều thiết bị ChromeOS vào một đơn vị tổ chức. |
|
Cập nhật các thuộc tính có thể cập nhật của thiết bị, chẳng hạn như annotatedUser , annotatedLocation , notes , orgUnitPath hoặc annotatedAssetId . |
|
Cập nhật các thuộc tính có thể cập nhật của thiết bị, chẳng hạn như annotatedUser , annotatedLocation , notes , orgUnitPath hoặc annotatedAssetId . |