Zasób: ChromeOsDevice
Urządzenia z Google Chrome działają w systemie ChromeOS. Więcej informacji o typach zadań wykonywanych za pomocą interfejsu 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 ChromeOS. |
serialNumber |
Numer seryjny urządzenia z Chrome wpisany podczas włączania urządzenia. Ta wartość jest taka sama jak Numer seryjny w 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 podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
supportEndDate |
Ostatnia data, w której urządzenie będzie obsługiwane. Dotyczy to tylko urządzeń kupionych bezpośrednio od Google. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
annotatedUser |
Użytkownik urządzenia wskazany przez administratora. Maksymalna długość to 100 znaków. Dozwolone są puste wartości. |
annotatedLocation |
Adres lub lokalizacja urządzenia podane przez administratora. Maksymalna długość to |
notes |
Notatki dotyczące 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, ten obiekt nie jest uwzględniany w odpowiedzi. |
meid |
Identyfikator urządzenia mobilnego (MEID) lub identyfikator IMEI karty 3G w urządzeniu mobilnym. Numer MEID/IMEI jest zwykle używany podczas dodawania urządzenia do abonamentu operatora sieci komórkowej. Jeśli urządzenie nie ma tych informacji, ten obiekt nie jest uwzględniany w odpowiedzi. Więcej informacji o eksportowaniu listy MEID/IMEI znajdziesz w Przewodniku dla programistów. |
orderNumber |
Numer zamówienia urządzenia. Numer zamówienia mają tylko urządzenia kupione bezpośrednio od Google. |
willAutoRenew |
Określa, czy po dacie zakończenia pomocy urządzenie będzie automatycznie odnawiać pomoc. Jest to właściwość tylko do odczytu. |
osVersion |
Wersja systemu operacyjnego urządzenia z ChromeOS. |
platformVersion |
Wersja platformy urządzenia z Chrome. |
firmwareVersion |
Wersja oprogramowania układowego urządzenia z ChromeOS. |
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 ostatniej rejestracji urządzenia. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
kind |
Typ zasobu. W przypadku zasobu Chromeosdevices wartość to |
recentUsers[] |
Lista ostatnich użytkowników urządzenia w kolejności malejącej według daty ostatniego logowania. |
recentUsers[].type |
Typ użytkownika. Akceptowane wartości:
|
recentUsers[].email |
Adres e-mail użytkownika. Jest on obecny tylko wtedy, gdy typ użytkownika to |
activeTimeRanges[] |
Lista aktywnych zakresów czasu (tylko do odczytu). |
activeTimeRanges[].activeTime |
Czas korzystania w milisekundach. |
activeTimeRanges[].date |
Data użycia. |
ethernetMacAddress |
Adres MAC urządzenia w interfejsie sieci Ethernet. |
annotatedAssetId |
Identyfikator zasobu oznaczony adnotacją przez administratora lub określony podczas rejestracji. |
etag |
ETag zasobu. |
diskVolumeReports[] |
Raporty o miejscu na dysku i inne informacje o zamontowanych/podłączonych woluminach. |
diskVolumeReports[].volumeInfo[] |
Woluminy dysków |
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 na urządzeniu w bajtach. |
cpuStatusReports[] |
Raporty wykorzystania i temperatury procesora (tylko do odczytu) |
cpuStatusReports[].reportTime |
Data i godzina otrzymania zgłoszenia. |
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 w urządzeniu. |
cpuInfo[].model |
Nazwa modelu procesora. |
cpuInfo[].architecture |
Architektura procesora. |
cpuInfo[].maxClockSpeedKhz |
Maksymalna szybkość zegara procesora w kHz. |
cpuInfo[].logicalCpus[] |
Informacje o procesorach logicznych |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Maksymalna częstotliwość, z jaką procesor może pracować zgodnie z zasadami. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Bieżąca częstotliwość pracy procesora. |
cpuInfo[].logicalCpus[].idleDuration |
Czas bezczynności od ostatniego uruchomienia. Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „ |
cpuInfo[].logicalCpus[].cStates[] |
Stany 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 miejscami po przecinku, zakończony znakiem „ |
deviceFiles[] |
Lista plików urządzeń 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 zgłoszenia. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Zawiera ostatnią znaną sieć (tylko do odczytu) |
lastKnownNetwork[].ipAddress |
Adres IP. |
lastKnownNetwork[].wanIpAddress |
Adres IP sieci WAN. |
autoUpdateExpiration |
(Tylko do odczytu) Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome lub pomoc. Zamiast niego użyj „autoUpdateThrough”. |
ethernetMacAddress0 |
(Tylko do odczytu) Adres MAC używany przez wewnętrzny port Ethernet Chromebooka i wbudowany interfejs sieciowy (Ethernet). Format to 12 cyfr szesnastkowych bez separatora (wielkie litery). Dotyczy to tylko niektórych urządzeń. |
dockMacAddress |
(Tylko do odczytu) Wbudowany adres MAC stacji dokującej, do której podłączone jest urządzenie. Fabrycznie ustawiony adres MAC przypisany do używania przez stację dokującą. Jest ona zarezerwowana specjalnie dla zasad dotyczących urządzeń z funkcją przekazywania adresu MAC. Format to 12 cyfr szesnastkowych bez 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ązanej 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 reprezentowana przez ukośnik |
tpmVersionInfo |
Moduł zaufanej platformy (TPM) (tylko do odczytu) |
tpmVersionInfo.family |
Rodzina TPM. Używamy kodowania w stylu TPM 2.0, np.: |
tpmVersionInfo.specLevel |
Poziom specyfikacji modułu TPM. Zobacz specyfikację biblioteki dla modułu TPM 2.0 i specyfikację główną dla modułu TPM 1.2. |
tpmVersionInfo.manufacturer |
Kod producenta modułu TPM. |
tpmVersionInfo.tpmModel |
Numer modelu TPM. |
tpmVersionInfo.firmwareVersion |
Wersja oprogramowania TPM. |
tpmVersionInfo.vendorSpecific |
Informacje specyficzne dla dostawcy, takie jak identyfikator dostawcy. |
screenshotFiles[] |
Lista 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 czytelna dla człowieka wersja identyfikatora orgUnitId. Właściwość orgUnitPath może się zmienić, jeśli zmienisz nazwę jednostki organizacyjnej w ścieżce, ale właściwość orgUnitId jest niezmienna w przypadku jednej jednostki organizacyjnej. Tę właściwość można zaktualizować za pomocą interfejsu API. Więcej informacji o tworzeniu struktury organizacyjnej urządzenia znajdziesz w Centrum pomocy dla administratorów. |
osUpdateStatus |
Stan aktualizacji systemu operacyjnego na urządzeniu. |
firstEnrollmentTime |
Data i godzina pierwszego zarejestrowania urządzenia. |
lastDeprovisionTimestamp |
(Tylko do odczytu) Data i godzina ostatniego wycofania 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. |
autoUpdateThrough |
Tylko dane wyjściowe. Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome lub pomoc. |
extendedSupportEligible |
Tylko dane wyjściowe. Wskazuje, czy urządzenie wymaga akceptacji pomocy rozszerzonej. |
extendedSupportStart |
Tylko dane wyjściowe. Data, od której urządzenie jest objęte zasadami pomocy rozszerzonej w zakresie automatycznych aktualizacji. |
extendedSupportEnabled |
Tylko dane wyjściowe. Określa, czy na urządzeniu jest włączona zasada pomocy rozszerzonej. |
fanInfo[] |
Tylko dane wyjściowe. Informacje o wentylatorze urządzenia. |
chromeOsType |
Tylko dane wyjściowe. Typ urządzenia z ChromeOS. |
diskSpaceUsage |
Tylko dane wyjściowe. Dane na temat ilości miejsca na dysku dostępnego na urządzeniu i używanego przez nie. |
osVersionCompliance |
Tylko dane wyjściowe. Stan zgodności wersji systemu operacyjnego z zasadami dotyczącymi urządzeń. |
OsUpdateStatus
Zawiera informacje o bieżącym stanie aktualizacji systemu operacyjnego.
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
state |
Stan aktualizacji systemu operacyjnego. |
targetOsVersion |
Pobieranie i stosowanie nowej wersji platformy obrazu systemu operacyjnego. Jest ustawiany tylko wtedy, gdy stan aktualizacji to UPDATE_STATUS_DOWNLOAD_IN_PROGRESS lub UPDATE_STATUS_NEED_REBOOT. Pamiętaj, że w niektórych przypadkach może to być fikcyjny adres „0.0.0.0” w przypadku stanu UPDATE_STATUS_NEED_REBOOT, np. gdy silnik aktualizacji zostanie ponownie uruchomiony bez ponownego uruchamiania urządzenia. |
targetKioskAppVersion |
Nowa wymagana wersja platformy z oczekującej aktualizacji aplikacji typu kiosk. |
updateTime |
Data i godzina ostatniej pomyślnej aktualizacji systemu operacyjnego. |
updateCheckTime |
Data i godzina ostatniego sprawdzenia 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 |
Aktualizacja oczekuje na rozpoczęcie. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Pobieranie oczekującej aktualizacji. |
UPDATE_STATE_NEED_REBOOT |
Urządzenie jest gotowe do zainstalowania aktualizacji, ale musi zostać ponownie uruchomione. |
DeprovisionReason
Powód wyrejestrowania urządzenia z ChromeOS.
Wartości w polu enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Przyczyna wycofania 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 na urządzeniu wygasła. |
DEPROVISION_REASON_OTHER |
Urządzenie zostało wyrejestrowane z powodu starszego, nieobsługiwanego już powodu. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Wymiana na inny model. Zastępujesz to urządzenie wyższym 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 |
Przejście z urządzeń z ChromeOS Flex. Masz urządzenie z ChromeOS Flex, które w ciągu roku wymienisz 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 go ustawić tylko w Centrum Serwisowym podczas 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 |
Urządzenie jest połączone z bezterminową licencją na Chrome Education. |
KIOSK_UPGRADE |
Urządzenie ma roczną licencję na kioski. |
ENTERPRISE_UPGRADE_PERPETUAL |
Wskazuje, że urządzenie korzysta z samodzielnej, bezterminowej licencji na Chrome Enterprise lub licencji Chrome Enterprise. |
ENTERPRISE_UPGRADE_FIXED_TERM |
Oznacza, że urządzenie korzysta z samodzielnej licencji na Chrome Enterprise o określonym czasie trwania lub z licencji na Chrome Enterprise. |
EDUCATION_UPGRADE_PERPETUAL |
Oznacza, że urządzenie korzysta z samodzielnej, bezterminowej licencji na Chrome Education(czyli bezterminowej licencji Chrome EDU). |
EDUCATION_UPGRADE_FIXED_TERM |
Wskazuje, że urządzenie korzysta z samodzielnej licencji na Chrome Education o określonym czasie trwania(czyli licencji Chrome EDU o określonym czasie trwania). |
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. Przydatne, jeśli dzwoniący musi skorelować te informacje z innymi. |
maxBrightness |
Tylko dane wyjściowe. Maksymalna jasność podświetlenia. |
brightness |
Tylko dane wyjściowe. Bieżąca jasność podświetlenia w zakresie od 0 do maxBrightness. |
FanInfo
Informacje o wentylatorze urządzenia.
Zapis JSON |
---|
{ "speedRpm": integer } |
Pola | |
---|---|
speedRpm |
Tylko dane wyjściowe. Szybkość wentylatora w obr./min. |
ChromeOsType
Typ urządzenia z ChromeOS.
Wartości w polu enum | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Typ ChromeOS nieokreślony. |
CHROME_OS_FLEX |
Typ ChromeOS to ChromeOS Flex. |
CHROME_OS |
Chrome OS Type Chrome OS. |
ByteUsage
Reprezentuje pojemność danych z określoną ilością bieżącego wykorzystania w bajtach.
Zapis JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
Pola | |
---|---|
capacityBytes |
Tylko dane wyjściowe. Łączna pojemność w bajtach. |
usedBytes |
Tylko dane wyjściowe. Bieżąca wartość wykorzystania w bajtach. |
Zgodność
Stan zgodności wersji systemu operacyjnego z zasadami dotyczącymi urządzeń.
Wartości w polu enum | |
---|---|
COMPLIANCE_UNSPECIFIED |
Stan zgodności nieokreślony. |
COMPLIANT |
Stan zgodności: zgodny. |
PENDING |
Stan zgodności oczekuje. |
NOT_COMPLIANT |
Stan zgodności: niezgodny. |
Metody |
|
---|---|
(deprecated) |
Zamiast niej używaj BatchChangeChromeOsDeviceStatus. |
|
Pobiera właściwości urządzenia z ChromeOS. |
|
Pobiera stronicowaną listę urządzeń z ChromeOS na koncie. |
|
Przenosi lub wstawia wiele urządzeń z ChromeOS do jednostki organizacyjnej. |
|
Aktualizuje właściwości urządzenia, które można aktualizować, takie jak annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |
|
Aktualizuje właściwości urządzenia, które można aktualizować, takie jak annotatedUser , annotatedLocation , notes , orgUnitPath lub annotatedAssetId . |