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 được 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 thiết bị được hỗ trợ. Điều khoản này chỉ áp dụng cho những 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ị theo ghi nhận của quản trị viên. Độ dài tối đa là 100 ký tự. Cho phép giá trị trống. |
annotatedLocation |
Địa chỉ hoặc vị trí của thiết bị theo ghi nhận của 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ó trong 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) cho thẻ di động 3G trong 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ó trong 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ị đượ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 dịch vụ 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 đưa vào 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ờ gần đây nhất thiết bị được đăng ký. 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. Thuộc tính này chỉ xuất hiện nếu loại người dùng là |
activeTimeRanges[] |
Danh sách các phạm vi thời gian đang hoạt động (Chỉ có thể đọ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 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ề các phương tiện được gắn/kết nối. |
diskVolumeReports[].volumeInfo[] |
Dung lượng ổ đĩa |
diskVolumeReports[].volumeInfo[].volumeId |
Mã nhận dạng 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ề nhiệt độ và mức sử dụng CPU (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 độ theo độ 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 mà CPU đang chạy. |
cpuInfo[].logicalCpus[].idleDuration |
Thời gian rảnh 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 " |
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 phát hành. |
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, có tối đa 9 chữ số thập phân, kết thúc bằng " |
deviceFiles[] |
Danh sách tệp thiết bị cần tải xuống (Chỉ có thể đọ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ó sẵn (Chỉ có thể đọ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ó thể đọ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 sau đó thiết bị sẽ ngừng nhận được bản cập nhật hoặc dịch vụ hỗ trợ của Chrome. Thay vào đó, hãy sử dụng "autoUpdateThrough". |
ethernetMacAddress0 |
(Chỉ có thể đọc) Địa chỉ MAC mà cổng Ethernet nội bộ của Chromebook sử dụng và cho giao diện mạng (Ethernet) trên máy. Định dạng là 12 (12) chữ số thập lục phân không có dấu phân cách nào (chữ cái viết hoa). Điều này chỉ liên quan đến một số thiết bị. |
dockMacAddress |
(Chỉ có thể đọc) Địa chỉ MAC tích hợp cho đế sạc mà thiết bị đã kết nối. Nhà sản xuất đặt địa chỉ Kiểm soát quyền truy cập vào nội dung đa phương tiện (địa chỉ MAC) được chỉ định để đế sạc sử dụng. Mã này được dành riêng cho chính sách truyền MAC qua thiết bị. Định dạng là 12 (12) chữ số thập lục phân không có dấu phân cách nào (chữ cái viết hoa). Điều này chỉ liên quan đến một số thiết bị. |
manufactureDate |
(Chỉ có thể đọc) Ngày sản xuất thiết bị theo định dạng yyyy-mm-dd. |
orgUnitPath |
Đường dẫn gốc đầy đủ 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ó thể đọc) |
tpmVersionInfo.family |
Nhóm TPM. Chúng tôi sử dụng phương thức mã hoá kiểu TPM 2.0, ví dụ: |
tpmVersionInfo.specLevel |
Cấp độ quy cách TPM. Xem Quy cách thư viện cho TPM 2.0 và Quy cách 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 dành riêng cho 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 cần 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ù bạn có thể thay đổi orgUnitPath 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 cho 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ấu trúc tổ chức cho thiết bị, hãy xem trung tâm trợ giúp dành cho quản trị viên. |
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ờ đăng ký thiết bị lần đầu. |
lastDeprovisionTimestamp |
(Chỉ có thể đọc) Ngày và giờ của lần gỡ bỏ quyền truy cập gần đây nhất đối với thiết bị. |
deprovisionReason |
(Chỉ có thể đọ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ị. |
autoUpdateThrough |
Chỉ có đầu ra. Dấu thời gian sau đó thiết bị sẽ ngừng nhận được 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 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ó được bật trên thiết bị hay không. |
fanInfo[] |
Chỉ có đầu ra. Thông tin về quạt cho thiết bị. |
chromeOsType |
Chỉ có đầu ra. Loại Chrome OS của thiết bị. |
diskSpaceUsage |
Chỉ có đầu ra. Dung lượng ổ đĩa mà thiết bị có sẵn và đang sử dụng. |
OsUpdateStatus
Chứa thông tin về trạng thái cập nhật hệ điều hành hiện tại.
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. Giá trị 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 ý rằng đây có thể là giá trị "0.0.0.0" giả cho UPDATE_STATUS_NEED_REBOOT trong 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 đang chờ cập nhật. |
updateTime |
Ngày và giờ 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 |
Trạng thái cập nhật chưa được chỉ định. |
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 |
Bản cập nhật đang chờ xử lý đang được tải 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 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 |
Tên miền của thiết bị đã được thay đổi. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Dịch vụ đã hết hạn đối với thiết bị. |
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ế bằng 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 |
Không cần sử dụng thiết bị đã chọn nữa. 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 sang bản nâng cấp ChromeOS Flex. Đây là thiết bị ChromeOS Flex mà bạn sắp thay thế bằng một chiếc máy Chromebook trong vòng một năm. |
DEPROVISION_REASON_NOT_REQUIRED |
Bạn không cần phải đưa ra lý do. Ví dụ: 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 cho thiết bị. Chỉ có Trung tâm bảo dưỡng sửa chữa mới có thể đặt trong quá trình yêu cầu bảo hành. |
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ị đi kèm với 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 riêng theo 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ị này đi kèm với 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 kết với thông tin khác. |
maxBrightness |
Chỉ có đầu ra. Độ sáng tối đa của đè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 vòng/phút. |
ChromeOsType
Loại Chrome OS của thiết bị.
Enum | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Loại Chrome OS không được chỉ định. |
CHROME_OS_FLEX |
Chrome OS Loại Chrome OS Flex. |
CHROME_OS |
Chrome OS Loại Chrome OS. |
ByteUsage
Biểu thị dung lượng dữ liệu với một số lượng sử dụng hiện tại tính bằng byte.
Biểu diễn dưới dạng JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
Trường | |
---|---|
capacityBytes |
Chỉ có đầu ra. Tổng dung lượng, tính bằng byte. |
usedBytes |
Chỉ có đầu ra. Giá trị sử dụng hiện tại, tính bằng byte. |
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ị Chrome OS. |
|
Truy xuất danh sách phân trang các thiết bị Chrome OS trong một tài khoản. |
|
Di chuyển hoặc chèn nhiều thiết bị Chrome OS 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 . |