Zasób: ChromeOsDevice
Na urządzeniach z Google Chrome działa Chrome OS. Więcej informacji o typowych zadaniach związanych z interfejsem API znajdziesz w Przewodniku dla programistów.
Zapis 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 ( |
Pola | |
---|---|
deviceId |
Unikalny identyfikator urządzenia z Chrome. |
serialNumber |
Numer seryjny urządzenia z Chrome wpisany podczas włączania urządzenia. Ta wartość jest taka sama jak numer seryjny konsoli administracyjnej na karcie Urządzenia z Chrome OS. |
status |
Stan urządzenia. Akceptowane wartości:
|
lastSync |
Data i godzina ostatniej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formie |
supportEndDate |
Ostateczna data, do której urządzenie będzie obsługiwane. Dotyczy to tylko urządzeń zakupionych bezpośrednio od Google. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formie |
annotatedUser |
Użytkownik urządzenia wskazany przez administratora. Maksymalna długość to 100 znaków. Puste wartości są dozwolone. |
annotatedLocation |
Adres lub lokalizacja urządzenia zgodnie z danymi administratora. Maksymalna długość to |
notes |
Notatki na temat tego urządzenia dodane przez administratora. Tę właściwość można wyszukiwać za pomocą parametru |
model |
Informacje o modelu urządzenia. Jeśli urządzenie nie ma tych informacji, ta właściwość nie zostanie uwzględniona w odpowiedzi. |
meid |
Identyfikator MEID (Mobile Equipment Identifier) lub identyfikator IMEI (International Mobile Equipment Identity) karty 3G w urządzeniu mobilnym. Identyfikator MEID/IMEI jest zwykle używany podczas dodawania urządzenia do abonamentu operatora usług bezprzewodowych. Jeśli urządzenie nie ma tych informacji, ta właściwość nie zostanie uwzględniona w odpowiedzi. Więcej informacji o eksportowaniu listy identyfikatorów MEID/IMEI znajdziesz w przewodniku dla programistów. |
orderNumber |
Numer zamówienia urządzenia. Tylko urządzenia kupione bezpośrednio od Google mają numer zamówienia. |
willAutoRenew |
Określa, czy urządzenie będzie automatycznie odnawiane po dacie zakończenia świadczenia pomocy technicznej. Ta właściwość jest tylko do odczytu. |
osVersion |
Wersja systemu operacyjnego urządzenia z Chrome. |
platformVersion |
Wersja platformy urządzenia z Chrome. |
firmwareVersion |
Wersja oprogramowania układowego urządzenia z Chrome. |
macAddress |
Adres MAC urządzenia bezprzewodowego. Jeśli na urządzeniu nie ma tych informacji, odpowiedź nie zostanie uwzględniona. |
bootMode |
Tryb uruchamiania urządzenia. Możliwe wartości to:
|
lastEnrollmentTime |
Data i godzina ostatniej rejestracji urządzenia. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formie |
kind |
Typ zasobu. W przypadku zasobu Chromeosdevices wartość to |
recentUsers[] |
Lista ostatnich użytkowników urządzenia w kolejności malejącej według czasu ostatniego logowania. |
recentUsers[].type |
Typ użytkownika. Akceptowane wartości:
|
recentUsers[].email |
Adres e-mail użytkownika. Ta wartość występuje tylko wtedy, gdy typ użytkownika to |
activeTimeRanges[] |
Lista aktywnych zakresów czasu (tylko do odczytu). |
activeTimeRanges[].activeTime |
Czas użycia w milisekundach. |
activeTimeRanges[].date |
Data użycia. |
ethernetMacAddress |
Adres MAC urządzenia w interfejsie sieci Ethernet. |
annotatedAssetId |
Identyfikator zasobu podany przez administratora lub podany podczas rejestracji. |
etag |
ETag zasobu. |
diskVolumeReports[] |
Raporty o miejscu na dysku i inne informacje o podłączonych/połączonych woluminach. |
diskVolumeReports[].volumeInfo[] |
Woluminy dysku |
diskVolumeReports[].volumeInfo[].volumeId |
Identyfikator woluminu |
diskVolumeReports[].volumeInfo[].storageTotal |
Całkowita ilość miejsca na dysku [w bajtach] |
diskVolumeReports[].volumeInfo[].storageFree |
Wolne miejsce na dysku [w bajtach] |
systemRamTotal |
Łączna ilość pamięci RAM na urządzeniu w bajtach |
cpuStatusReports[] |
Raporty o wykorzystaniu i temperaturze procesora (tylko do odczytu) |
cpuStatusReports[].reportTime |
Data i godzina otrzymania raportu. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Lista próbek temperatury procesora. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura w stopniach Celsjusza. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Etykieta procesora |
cpuInfo[] |
Informacje o danych technicznych procesora urządzenia. |
cpuInfo[].model |
Nazwa modelu procesora. |
cpuInfo[].architecture |
Architektura procesora. |
cpuInfo[].maxClockSpeedKhz |
Maksymalna częstotliwość zegara procesora w kHz. |
cpuInfo[].logicalCpus[] |
Informacje o procesorach logicznych |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Maksymalna częstotliwość, z jaką procesor może działać, według zasady. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Bieżąca częstotliwość, z jaką działa procesor. |
cpuInfo[].logicalCpus[].idleDuration |
Czas bezczynności od ostatniego uruchomienia. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
cpuInfo[].logicalCpus[].cStates[] |
Wartości C wskazują stan zużycia energii przez procesor. Więcej informacji znajdziesz w dokumentacji opublikowanej przez producenta procesora. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Nazwa stanu. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Czas spędzony w tym stanie od ostatniego ponownego uruchomienia. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
deviceFiles[] |
Lista plików na urządzeniu do pobrania (tylko do odczytu) |
deviceFiles[].name |
Nazwa pliku |
deviceFiles[].type |
Typ pliku |
deviceFiles[].downloadUrl |
Adres URL pobierania pliku |
deviceFiles[].createTime |
Data i godzina utworzenia pliku |
systemRamFreeReports[] |
Raporty o ilości dostępnej pamięci RAM (tylko do odczytu) |
systemRamFreeReports[].reportTime |
Data i godzina otrzymania raportu. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Zawiera ostatnią znaną sieć (tylko do odczytu) |
lastKnownNetwork[].ipAddress |
Adres IP. |
lastKnownNetwork[].wanIpAddress |
Adres IP w sieci WAN. |
autoUpdateExpiration |
(Tylko do odczytu) Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome lub nie będzie obsługiwać obsługi. |
ethernetMacAddress0 |
(Tylko do odczytu) Adres MAC używany przez wewnętrzny port Ethernet Chromebooka oraz wbudowany interfejs sieci Ethernet. Format to 12 cyfr szesnastkowych bez żadnego separatora (wielkie litery). Dotyczy to tylko niektórych urządzeń. |
dockMacAddress |
(Tylko do odczytu) Wbudowany adres MAC stacji dokującej, do której urządzenie jest podłączone. Na poziomie fabrycznym został ustawiony adres kontroli dostępu do multimediów (adres MAC) przypisany do użycia przez stację dokującą. Jest zarezerwowana specjalnie na potrzeby zasad dotyczących urządzeń przekazywanych przez MAC. Format to 12 cyfr szesnastkowych bez żadnego separatora (wielkie litery). Dotyczy to tylko niektórych urządzeń. |
manufactureDate |
(Tylko do odczytu) Data produkcji urządzenia w formacie rrrr-mm-dd. |
orgUnitPath |
Pełna ścieżka nadrzędna z nazwą jednostki organizacyjnej powiązaną z urządzeniem. Wielkość liter w nazwach ścieżek nie jest rozróżniana. Jeśli nadrzędna jednostka organizacyjna jest organizacją najwyższego poziomu, jest oznaczona ukośnikiem: |
tpmVersionInfo |
TPM (Trusted Platform Module) (tylko do odczytu) |
tpmVersionInfo.family |
Rodzina TPM. Używamy kodowania TPM 2.0, np.: |
tpmVersionInfo.specLevel |
Poziom specyfikacji TPM. Patrz: specyfikacja biblioteki dotycząca TPM 2.0 i główna specyfikacja dla TPM 1.2. |
tpmVersionInfo.manufacturer |
Kod producenta TPM. |
tpmVersionInfo.tpmModel |
Numer modelu TPM. |
tpmVersionInfo.firmwareVersion |
Wersja oprogramowania TPM. |
tpmVersionInfo.vendorSpecific |
informacje o poszczególnych dostawcach, np. identyfikator dostawcy; |
screenshotFiles[] |
Lista plików ze zrzutami ekranu do pobrania. Typ to zawsze „SCREENSHOT_FILE”. (Tylko do odczytu) |
screenshotFiles[].name |
Nazwa pliku |
screenshotFiles[].type |
Typ pliku |
screenshotFiles[].downloadUrl |
Adres URL pobierania pliku |
screenshotFiles[].createTime |
Data i godzina utworzenia pliku |
orgUnitId |
Unikalny identyfikator jednostki organizacyjnej. orgUnitPath to czytelna dla człowieka wersja jednostki organizacyjnej orgUnitId. Chociaż parametr orgUnitPath może się zmienić przez zmianę nazwy jednostki organizacyjnej w ścieżce, nie można tego zmienić w przypadku jednej jednostki organizacyjnej. Tę właściwość można aktualizować za pomocą interfejsu API. Więcej informacji na temat tworzenia struktury organizacyjnej na urządzeniu znajdziesz w Centrum pomocy dla administratorów. |
osUpdateStatus |
Stan aktualizacji systemu operacyjnego urządzenia. |
firstEnrollmentTime |
Data i godzina pierwszej rejestracji urządzenia. |
lastDeprovisionTimestamp |
(Tylko do odczytu) Data i godzina ostatniego wyrejestrowania urządzenia. |
deprovisionReason |
(Tylko do odczytu) Przyczyna wyrejestrowania. |
deviceLicenseType |
Tylko dane wyjściowe. Typ licencji urządzenia. |
backlightInfo[] |
Tylko dane wyjściowe. Zawiera informacje o podświetleniu urządzenia. |
OsUpdateStatus
Zawiera informacje o bieżącym stanie aktualizacji systemu operacyjnego.
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
state |
Stan aktualizacji systemu operacyjnego. |
targetOsVersion |
Nowa wersja platformy obrazu systemu operacyjnego, który jest pobierany i stosowany. Jest ustawiana tylko wtedy, gdy stan aktualizacji to UPDATE_STATUS_download_IN_PROGRESS lub UPDATE_STATUS_NEED_REBOOT. Pamiętaj, że w niektórych przypadkach brzegowych może to być przykładowy „0.0.0.0” dla stanu UPDATE_STATUS_NEED_REBOOT, np. w przypadku gdy mechanizm aktualizacji został uruchomiony ponownie bez ponownego uruchamiania systemu. |
targetKioskAppVersion |
Nowa wymagana wersja platformy z oczekującej zaktualizowanej aplikacji kiosku. |
updateTime |
Data i godzina ostatniej udanej aktualizacji systemu operacyjnego. |
updateCheckTime |
Data i godzina ostatniego sprawdzenia dostępności aktualizacji. |
rebootTime |
Data i godzina ostatniego ponownego uruchomienia. |
UpdateState
Stan aktualizacji systemu operacyjnego.
Wartości w polu enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Stan aktualizacji jest nieokreślony. |
UPDATE_STATE_NOT_STARTED |
Masz oczekującą aktualizację, ale ona się jeszcze nie rozpoczęła. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Trwa pobieranie oczekującej aktualizacji. |
UPDATE_STATE_NEED_REBOOT |
Urządzenie jest gotowe do zainstalowania aktualizacji, ale musi się zrestartować. |
DeprovisionReason
Przyczyna wyrejestrowania urządzenia z ChromeOS.
Wartości w polu enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Przyczyna wyrejestrowania jest nieznana. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Wymiana na taki sam model. Masz numer RMA lub wymieniasz wadliwe urządzenie objęte gwarancją na ten sam model. |
DEPROVISION_REASON_UPGRADE |
Urządzenie zostało uaktualnione. |
DEPROVISION_REASON_DOMAIN_MOVE |
Zmieniono domenę urządzenia. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Usługa wygasła dla urządzenia. |
DEPROVISION_REASON_OTHER |
Urządzenie zostało wyrejestrowane z powodu starszego typu, który nie jest już obsługiwany. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Wymiana na inny model. Zastępujesz to urządzenie nowym lub nowszym modelem. |
DEPROVISION_REASON_RETIRING_DEVICE |
Wycofanie z floty. Wyrzucasz urządzenie, przekazujesz je w ramach darowizny lub wycofujesz je z użycia w inny sposób. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Przeniesienie licencji na ChromeOS Flex. To urządzenie z ChromeOS Flex, które w ciągu roku wymieniasz na Chromebooka. |
DEPROVISION_REASON_NOT_REQUIRED |
Przyczyna nie była wymagana. Na przykład licencje zostały zwrócone do puli licencji klienta. |
DEPROVISION_REASON_REPAIR_CENTER |
Urządzenie zostało wyrejestrowane przez centrum serwisowe. To ustawienie można ustawić w centrum serwisowym tylko w czasie RMA. |
DeviceLicenseType
Typ licencji tego urządzenia.
Wartości w polu enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Typ licencji jest nieznany. |
ENTERPRISE |
Urządzenie jest połączone z bezterminową licencją na Chrome Enterprise. |
ENTERPRISE_UPGRADE |
urządzenie ma roczną samodzielną licencję na Chrome Enterprise, |
EDUCATION_UPGRADE |
Urządzenie ma bezterminową, samodzielną licencję na Chrome Education. |
EDUCATION |
Z urządzeniem jest w pakiecie bezterminowa licencja na Chrome Education. |
KIOSK_UPGRADE |
Urządzenie ma roczną licencję na kiosk. |
BacklightInfo
Informacje o podświetleniu urządzenia.
Zapis JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Pola | |
---|---|
path |
Tylko dane wyjściowe. Ścieżka do tego podświetlenia w systemie. Ta opcja jest przydatna, jeśli element wywołujący musi być powiązany z innymi informacjami. |
maxBrightness |
Tylko dane wyjściowe. Maksymalna jasność podświetlenia. |
brightness |
Tylko dane wyjściowe. Bieżąca jasność podświetlenia: od 0 do maksymalnej jasności. |
Metody |
|
---|---|
(deprecated) |
Użyj w zamian BatchChangeChromeOsDeviceStatus. |
|
Pobiera właściwości urządzenia z Chrome OS. |
|
Pobiera listę urządzeń z Chrome OS podzieloną na strony w ramach konta. |
|
Przenosi lub wstawia wiele urządzeń z Chrome OS do jednostki organizacyjnej. |
|
Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |
|
Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |