Zasób: ChromeOsDevice
Urządzenia z Google Chrome mają system 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 identyczna z numerem seryjnym konsoli administracyjnej na karcie Urządzenia z ChromeOS. |
status |
Stan urządzenia. Akceptowane wartości:
|
lastSync |
Data i godzina ostatniej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Wartość jest w formacie daty i godziny w standardzie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formularzu |
supportEndDate |
Ostateczna data, kiedy urządzenie będzie obsługiwane. Dotyczy to tylko urządzeń kupionych bezpośrednio od Google. Wartość jest w formacie daty i godziny w standardzie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formularzu |
annotatedUser |
Nazwa użytkownika urządzenia wskazanego przez administratora. Maksymalna długość to 100 znaków. Dozwolone są puste wartości. |
annotatedLocation |
Adres lub lokalizacja urządzenia zgodnie z informacjami podanymi przez 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 jest uwzględniona w odpowiedzi. |
meid |
Identyfikator MEID (Mobile Equipment Identifier) lub IMEI (International Mobile Equipment Identity) dla karty sieci komórkowej 3G w urządzeniu mobilnym. MEID/IMEI jest zwykle używany przy dodawaniu urządzenia do abonamentu u operatora. Jeśli urządzenie nie ma tych informacji, ta właściwość nie jest 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 odnawiać obsługę po dacie zakończenia świadczenia pomocy technicznej. Ta usługa 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 sieci bezprzewodowej urządzenia. Jeśli urządzenie nie ma tych informacji, nie są one uwzględniane w odpowiedzi. |
bootMode |
Tryb uruchamiania urządzenia. Możliwe wartości to:
|
lastEnrollmentTime |
Data i godzina ostatniego zarejestrowania urządzenia. Wartość jest w formacie daty i godziny w standardzie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formularzu |
kind |
Typ zasobu. W przypadku zasobu Chromeosdevices wartość wynosi |
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. Ten parametr jest dostępny tylko wtedy, gdy typ użytkownika to |
activeTimeRanges[] |
Lista aktywnych zakresów czasu (tylko do odczytu). |
activeTimeRanges[].activeTime |
Czas użytkowania w milisekundach. |
activeTimeRanges[].date |
Data użycia. |
ethernetMacAddress |
Adres MAC urządzenia w interfejsie sieci Ethernet. |
annotatedAssetId |
Identyfikator zasobu podany przez administratora lub określony podczas rejestracji. |
etag |
Tag ETag zasobu. |
diskVolumeReports[] |
Raporty dotyczące miejsca na dysku i inne informacje o podłączonych/podłączonych woluminach. |
diskVolumeReports[].volumeInfo[] |
Woluminy dysku |
diskVolumeReports[].volumeInfo[].volumeId |
Identyfikator woluminu |
diskVolumeReports[].volumeInfo[].storageTotal |
Łączna ilość miejsca na dysku [w bajtach] |
diskVolumeReports[].volumeInfo[].storageFree |
Wolne miejsce na dysku [w bajtach] |
systemRamTotal |
Łączna ilość pamięci RAM urządzenia w bajtach |
cpuStatusReports[] |
Raporty dotyczące wykorzystania i temperatury 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 specyfikacji procesora urządzenia. |
cpuInfo[].model |
Nazwa modelu procesora. |
cpuInfo[].architecture |
Architektura procesora. |
cpuInfo[].maxClockSpeedKhz |
Maksymalna częstotliwość taktowania procesora w kHz. |
cpuInfo[].logicalCpus[] |
Informacje dotyczące procesorów logicznych |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Maksymalna częstotliwość, z jaką może działać procesor, zgodnie z zasadą. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Bieżąca częstotliwość, z jaką procesor działa. |
cpuInfo[].logicalCpus[].idleDuration |
Czas bezczynności od ostatniego uruchomienia. Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „ |
cpuInfo[].logicalCpus[].cStates[] |
Stan C wskazuje stan zużycia energii przez procesor. Więcej informacji znajdziesz w dokumentacji opublikowanej przez producenta CPU. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Nazwa stanu. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Czas w stanie od ostatniego ponownego uruchomienia. Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
deviceFiles[] |
Lista plików z urządzenia 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 WAN. |
autoUpdateExpiration |
(Tylko do odczytu) Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome i obsługę. Użyj metody „autoUpdateThrough” . |
ethernetMacAddress0 |
(Tylko do odczytu) adres MAC używany przez wewnętrzny port Ethernet Chromebooka i dla wbudowanej sieci (Ethernet). Format to 12 (dwunastu) cyfr szesnastkowych bez separatora (wielkich liter). Dotyczy to tylko niektórych urządzeń. |
dockMacAddress |
(Tylko do odczytu) Wbudowany adres MAC stacji dokującej, z którą podłączyło się urządzenie. Ustawienia fabryczne ustawiają adres MAC (Media Access Control) na potrzeby stacji dokującej. Jest zarezerwowany na potrzeby zasad przekazywania MAC dotyczących urządzeń. Format to 12 (dwunastu) cyfr szesnastkowych bez separatora (wielkich liter). 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 wraz z nazwą jednostki organizacyjnej powiązaną z urządzeniem. W nazwach ścieżek wielkość liter nie jest rozróżniana. Jeśli nadrzędna jednostka organizacyjna jest organizacją najwyższego poziomu, jest ona reprezentowana jako ukośnik ( |
tpmVersionInfo |
Moduł TPM (Trusted Platform Module) (tylko do odczytu) |
tpmVersionInfo.family |
Rodzina TPM. Używamy kodowania stylu TPM 2.0, np.: |
tpmVersionInfo.specLevel |
Poziom specyfikacji TPM. Patrz Specyfikacja biblioteki dla TPM 2.0 i Specyfikacja główna TPM 1.2. |
tpmVersionInfo.manufacturer |
Kod producenta TPM. |
tpmVersionInfo.tpmModel |
Numer modelu TPM. |
tpmVersionInfo.firmwareVersion |
Wersja oprogramowania TPM. |
tpmVersionInfo.vendorSpecific |
Informacje specyficzne dla dostawcy, np. jego identyfikator. |
screenshotFiles[] |
listę plików zrzutów 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 możliwa do odczytania przez człowieka wersja elementu orgUnitId. Parametr orgUnitPath może się zmienić, zmieniając nazwę jednostki organizacyjnej w ścieżce, ale dla jednej jednostki organizacyjnej nie można zmienić tego parametru. Tę właściwość można aktualizować za pomocą interfejsu API. Więcej informacji na temat tworzenia struktury organizacyjnej dla urządzenia 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) Powód wyrejestrowania. |
deviceLicenseType |
Tylko dane wyjściowe. Typ licencji urządzenia. |
backlightInfo[] |
Tylko dane wyjściowe. Zawiera informacje o podświetleniu urządzenia. |
autoUpdateThrough |
Tylko dane wyjściowe. Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome i obsługę. |
extendedSupportEligible |
Tylko dane wyjściowe. Określa, czy urządzenie wymaga wyrażenia zgody na korzystanie z pomocy rozszerzonej. |
extendedSupportStart |
Tylko dane wyjściowe. Data uruchomienia zasady rozszerzonej pomocy dla automatycznych aktualizacji na urządzeniu. |
extendedSupportEnabled |
Tylko dane wyjściowe. Określa, czy na urządzeniu są włączone zasady pomocy rozszerzonej. |
fanInfo[] |
Tylko dane wyjściowe. Informacje o wentylatorze urządzenia. |
chromeOsType |
Tylko dane wyjściowe. Typ systemu operacyjnego Chrome na urządzeniu. |
OsUpdateStatus
Zawiera informacje o bieżącym stanie aktualizacji systemu operacyjnego.
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
state |
Stan aktualizacji systemu operacyjnego. |
targetOsVersion |
Nowa wersja platformy pobieranego i stosowanego obrazu systemu operacyjnego. Jest ustawiana tylko wtedy, gdy stan aktualizacji to UPDATE_STATUS_Download_IN_PROGRESS lub UPDATE_STATUS_NEED_REBOOT. Zwróć uwagę, że może to być przykładowa wartość „0.0.0.0”. dla stanu UPDATE_STATUS_NEED_REBOOT w przypadku niektórych skrajnych przypadków, np. to system zostanie ponownie uruchomiony bez ponownego uruchomienia. |
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 |
Istnieje oczekująca aktualizacja, która jeszcze się 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 zostać zrestartowane. |
DeprovisionReason
Powód wyrejestrowania urządzenia z ChromeOS.
Wartości w polu enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Przyczyna wyrejestrowania jest nieznana. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Wymiana na ten 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 |
Domena urządzenia została zmieniona. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Usługa dla tego urządzenia wygasła. |
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 |
Przenoszenie licencji na ChromeOS Flex. Jest 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. Można je ustawić tylko przez centrum serwisowe naprawy podczas RMA. |
DeviceLicenseType
Typ licencji tego urządzenia.
Wartości w polu enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Nieznany typ licencji. |
ENTERPRISE |
W pakiecie z urządzeniem jest bezterminowa licencja 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 |
W pakiecie z urządzeniem jest 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, gdy rozmówca chce powiązać inne informacje. |
maxBrightness |
Tylko dane wyjściowe. Maksymalna jasność podświetlenia. |
brightness |
Tylko dane wyjściowe. Bieżąca jasność podświetlenia od 0 do maxBrightness. |
FanInfo
Informacje o wentylatorze urządzenia.
Zapis JSON |
---|
{ "speedRpm": integer } |
Pola | |
---|---|
speedRpm |
Tylko dane wyjściowe. Szybkość wentylatora (obr./min). |
ChromeOsType
Typ systemu operacyjnego Chrome na urządzeniu.
Wartości w polu enum | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Typ systemu operacyjnego Chrome nieokreślony. |
CHROME_OS_FLEX |
Typ systemu operacyjnego Chrome: Chrome OS Flex. |
CHROME_OS |
Typ systemu operacyjnego Chrome: ChromeOS. |
Metody |
|
---|---|
(deprecated) |
Zamiast niego użyj parametru BatchChangeChromeOsDeviceStatus. |
|
Pobiera właściwości urządzenia z Chrome OS. |
|
Pobiera podzieloną na strony listę urządzeń z ChromeOS w obrębie konta. |
|
Przenosi lub wstawia wiele urządzeń z Chrome OS do jednostki organizacyjnej. |
|
Aktualizuje możliwe do aktualizacji właściwości urządzenia, np. annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |
|
Aktualizuje możliwe do aktualizacji właściwości urządzenia, np. annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |