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 thiết bị Chrome được nhập khi bật 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 tab Thiết bị ChromeOS. |
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ờ gần đây nhất mà thiết bị được đồng bộ hoá với các 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ị có đị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ị sẽ đượ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ị có đị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ị theo ghi chú của quản trị viên. Độ dài tối đa là 100 ký tự. Giá trị trống được phép. |
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 tài sản 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êu trên thì thuộc tính này sẽ không được đưa vào câu trả lờ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) cho 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êu trên thì thuộc tính này sẽ không được đưa vào câu trả lờ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 |
Mã số đơn đặt hàng của thiết bị. Chỉ những thiết bị được mua trực tiếp từ Google mới có số đơ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 đó sẽ không được đưa vào câu trả lời. |
bootMode |
Chế độ khởi động của 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ị có đị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 những 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. Thông tin này chỉ xuất hiện nếu kiểu người dùng là |
activeTimeRanges[] |
Danh sách phạm vi 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 do quản trị viên ghi chú hoặc được chỉ định trong quá trình đăng ký. |
etag |
ETag của tài nguyên. |
diskVolumeReports[] |
Báo cáo về dung lượng ổ đĩa và thông tin khác về ổ đĩa đã gắn/kết nối. |
diskVolumeReports[].volumeInfo[] |
Ổ đĩa |
diskVolumeReports[].volumeInfo[].volumeId |
Mã tập |
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) |
cpuStatusReports[].reportTime |
Ngày và giờ nhận 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 tối đa của CPU tính bằng kHz. |
cpuInfo[].logicalCpus[] |
Thông tin về CPU logic |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Theo chính sách, tần suất tối đa mà CPU được phép chạy. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Tần suất hiện tại mà CPU đang chạy. |
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ố phân số, 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 này 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ố phân số, kết thúc bằng " |
deviceFiles[] |
Danh sách các tệp trên thiết bị để 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 lượng bộ nhớ RAM còn trống (Chỉ đọc) |
systemRamFreeReports[].reportTime |
Ngày và giờ nhận 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 WAN. |
autoUpdateExpiration |
(Chỉ đọc) Dấu thời gian mà sau đó thiết bị sẽ ngừng nhận hỗ trợ hoặc bản cập nhật Chrome. Vui lòng sử dụng "autoUpdateThrough" thay thế. |
ethernetMacAddress0 |
Địa chỉ MAC (Chỉ đọc) đượ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 cách nào (chữ hoa). Chế độ này chỉ áp dụng cho một số thiết bị. |
dockMacAddress |
(Chỉ đọc) Địa chỉ MAC tích hợp sẵn cho đế sạc mà thiết bị đã kết nối. Nhà máy thiết lập địa chỉ kiểm soát quyền truy cập nội dung nghe nhìn (địa chỉ MAC) được chỉ định để đế sử dụng. Lớp này dành riêng cho chính sách thiết bị truyề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 cách nào (chữ hoa). Chế độ này chỉ áp dụng cho một số thiết bị. |
manufactureDate |
(Chỉ đọc) Ngày thiết bị được sản xuất ở định dạng yyyy-mm-dd. |
orgUnitPath |
Đường dẫn đầy đủ của nhà xuất bản 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ị dưới dạ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 |
Gia đình TPM. Chúng tôi sử dụng chế độ mã hoá kiểu TPM 2.0, ví dụ: |
tpmVersionInfo.specLevel |
Cấp thông số TPM. 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ã của nhà sản xuất TPM (Mô-đun nền tảng đáng tin cậy). |
tpmVersionInfo.tpmModel |
Số mô hình TPM. |
tpmVersionInfo.firmwareVersion |
Phiên bản chương trình cơ sở TPM. |
tpmVersionInfo.vendorSpecific |
Thông tin cụ thể về 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 có thể đọc được của orgUnitId. 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ập nhật hệ điều hành của thiết bị. |
firstEnrollmentTime |
Ngày và giờ lần đầu tiên thiết bị được đăng ký. |
lastDeprovisionTimestamp |
(Chỉ đọc) Ngày và giờ huỷ cấp phép thiết bị gần đây nhất. |
deprovisionReason |
(Chỉ đọc) Lý do hủy 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 của thiết bị. |
autoUpdateThrough |
Chỉ có đầu ra. Dấu thời gian mà sau đó thiết bị sẽ ngừng nhận bản cập nhật hoặc dịch vụ hỗ trợ của Chrome. |
extendedSupportEligible |
Chỉ có đầu ra. Thiết bị có yêu cầu chọn sử dụng dịch vụ hỗ trợ mở rộng hay không. |
extendedSupportStart |
Chỉ có đầu ra. Ngày của thiết bị khi chính sách hỗ trợ mở rộng dành cho bản cập nhật tự động bắt đầu. |
extendedSupportEnabled |
Chỉ có đầu ra. Liệu chính sách hỗ trợ mở rộng có đang bật trên thiết bị hay không. |
fanInfo[] |
Chỉ có đầu ra. Thông tin về quạt của thiết bị. |
chromeOsType |
Chỉ có đầu ra. Loại thiết bị chạy ChromeOS. |
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 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. Thuộc tính này chỉ được đặt khi trạng thái cập nhật là UPDATE_STATUS_DOWNLOAD_IN_PROGRESS hoặc UPDATE_STATUS_NEED_REBOOT. Lưu ý đâ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 bắt buộc mới từ ứng dụng kiosk đã cập nhật đang chờ xử lý. |
updateTime |
Ngày và thời gian của lần 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 bản cập nhật hệ điều hành.
Enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Chưa xác đị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 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 cũ. 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 |
Đã thay đổi miền của thiết bị. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Dịch vụ đã hết hạn đối với thiết bị. |
DEPROVISION_REASON_OTHER |
Thiết bị này đã bị huỷ cấp phép vì một lý do cũ không còn được hỗ trợ nữa. |
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 hoạt động trong 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 bắt buộc có lý do. Ví dụ: giấy phép được trả về bộ 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 thời gian RMA. |
DeviceLicenseType
Loại giấy phép của thiết bị này.
Enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Không xác định được loại giấy phép. |
ENTERPRISE |
Thiết bị này đi kèm với một Bản nâng cấp Chrome Enterprise vĩnh viễn. |
ENTERPRISE_UPGRADE |
Thiết bị có một Bản nâng cấp Chrome Enterprise độc lập hằng năm. |
EDUCATION_UPGRADE |
Thiết bị này có Bản nâng cấp Chrome Education độc lập vĩnh viễn. |
EDUCATION |
Thiết bị này đi kèm với một Bản nâng cấp Chrome Education vĩnh viễn. |
KIOSK_UPGRADE |
Thiết bị 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 liên quan đến 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, trong khoảng từ 0 đến maxBrightness. |
FanInfo
Thông tin về quạt của thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "speedRpm": integer } |
Trường | |
---|---|
speedRpm |
Chỉ có đầu ra. Tốc độ quạt tính bằng RPM. |
ChromeOsType
Loại thiết bị sử dụng ChromeOS.
Enum | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Chưa xác định Loại ChromeOS. |
CHROME_OS_FLEX |
Loại ChromeOS Flex. |
CHROME_OS |
Loại ChromeOS. |
Phương thức |
|
---|---|
(deprecated) |
Thay vào đó, hãy sử dụng BatchChangeChromeOsDeviceStatus. |
|
Truy xuất thuộc tính của thiết bị ChromeOS. |
|
Truy xuất danh sách thiết bị Chrome OS đượ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 . |