Zasób: ChromeOsDevice
Urządzenia Google Chrome działają na ChromeOS. Więcej informacji o popularnych zadaniach związanych z interfejsem API znajdziesz w przewodniku dla deweloperó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 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, do której urządzenie będzie obsługiwane. Dotyczy to tylko urządzeń zakupionych 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 oznaczony adnotacją przez administratora. Maksymalna długość to 100 znaków. Dozwolone są puste wartości. |
annotatedLocation |
Adres lub lokalizacja urządzenia oznaczone adnotacją przez administratora. Maksymalna długość to |
notes |
Notatki dotyczące urządzenia dodane przez administratora. Właściwości tej usługi można wyszukiwać za pomocą parametru |
model |
Informacje o modelu urządzenia. Jeśli urządzenie nie ma tych informacji, ta usługa nie jest uwzględniana w odpowiedzi. |
meid |
Identyfikator MEID lub identyfikator IMEI karty SIM 3G w urządzeniu mobilnym. Numer MEID/IMEI jest zwykle używany podczas dodawania urządzenia do planu płatnego operatora sieci komórkowej. Jeśli urządzenie nie ma tych informacji, ta usługa nie jest uwzględniana 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 urządzenie będzie automatycznie odnawiać obsługę po dacie zakończenia obsługi. 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 urządzenia z Chrome. |
macAddress |
Adres MAC bezprzewodowej karty sieciowej 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 czasu 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 czasowych (tylko do odczytu). |
activeTimeRanges[].activeTime |
Czas korzystania w milisekundach. |
activeTimeRanges[].date |
Data użycia. |
ethernetMacAddress |
Adres MAC urządzenia na 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 lub podłączonych woluminach. |
diskVolumeReports[].volumeInfo[] |
woluminy dysku, |
diskVolumeReports[].volumeInfo[].volumeId |
Identyfikator woluminu |
diskVolumeReports[].volumeInfo[].storageTotal |
Łączne miejsce na dysku [w bajtach] |
diskVolumeReports[].volumeInfo[].storageFree |
Wolne miejsce na dysku [w bajtach] |
systemRamTotal |
Łączna pamięć 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 urządzenia. |
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 działać zgodnie z zasadami. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Bieżąca częstotliwość pracy procesora. |
cpuInfo[].logicalCpus[].idleDuration |
Czas bezczynności od ostatniego uruchomienia. Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
cpuInfo[].logicalCpus[].cStates[] |
Stany C wskazują stan zużycia energii procesora. Więcej informacji znajdziesz w dokumentacji opublikowanej przez producenta procesora. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Nazwa stanu. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Czas spędzony w danym stanie od ostatniego ponownego uruchomienia. Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
deviceFiles[] |
Lista plików 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 dostępnej ilości 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 w sieci WAN. |
autoUpdateExpiration |
(Tylko do odczytu) Znak czasu, po którym urządzenie przestanie otrzymywać aktualizacje lub wsparcie dotyczące Chrome. Zamiast tego użyj opcji „autoUpdateThrough”. |
ethernetMacAddress0 |
(Tylko do odczytu) adres MAC używany przez wewnętrzny port Ethernet Chromebooka oraz przez interfejs sieciowy (Ethernet) wbudowany w urządzenie. Format to 12 cyfr szesnastkowych bez żadnych rozdzielaczy (duże 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 kontroli dostępu do nośnika (adres MAC) przypisany do stacji dokującej. Jest on zarezerwowany specjalnie do stosowania zasad dotyczących urządzeń z przekazywaniem adresów MAC. Format to 12 cyfr szesnastkowych bez żadnych rozdzielaczy (duże 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 do jednostki nadrzędnej z nazwą jednostki organizacyjnej powiązanej z urządzeniem. W nazwach ścieżek wielkość liter nie ma znaczenia. 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 TPM. Zobacz specyfikację biblioteki dla TPM 2.0 i specyfikację główną dla TPM 1.2. |
tpmVersionInfo.manufacturer |
Kod producenta modułu TPM. |
tpmVersionInfo.tpmModel |
Numer modelu TPM. |
tpmVersionInfo.firmwareVersion |
Wersja oprogramowania TPM. |
tpmVersionInfo.vendorSpecific |
informacje o 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ć, gdy zmienisz nazwę jednostki organizacyjnej w ścieżce, ale identyfikator orgUnitId jest niemodyfikowalny w przypadku danej 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 administracyjnej. |
osUpdateStatus |
Stan aktualizacji systemu operacyjnego na urządzeniu. |
firstEnrollmentTime |
Data i godzina pierwszego zarejestrowania urządzenia. |
lastDeprovisionTimestamp |
(Tylko do odczytu) Data i godzina ostatniego odblokowania 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. Znak czasu, po którym urządzenie przestanie otrzymywać aktualizacje lub wsparcie Chrome. |
extendedSupportEligible |
Tylko dane wyjściowe. Wskazuje, czy urządzenie wymaga akceptacji pomocy rozszerzonej. |
extendedSupportStart |
Tylko dane wyjściowe. Data, od której zaczną obowiązywać rozszerzone zasady 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 obecnie używanego przez nie. |
OsUpdateStatus
Zawiera informacje o bieżącym stanie aktualizacji systemu operacyjnego.
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
state |
Stan aktualizacji systemu operacyjnego. |
targetOsVersion |
nowa wersja obrazu systemu operacyjnego, która jest pobierana i zastępuje poprzednią. Jest on ustawiany tylko wtedy, gdy stan aktualizacji to UPDATE_STATUS_DOWNLOAD_IN_PROGRESS lub UPDATE_STATUS_NEED_REBOOT. Pamiętaj, że w niektórych szczególnych przypadkach (np. gdy mechanizm aktualizacji jest restartowany bez restartu) wartość parametru UPDATE_STATUS_NEED_REBOOT może być zastępcza i wynosić „0.0.0.0”. |
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 restartu. |
UpdateState
Stan aktualizacji systemu operacyjnego.
Wartości w polu enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Stan aktualizacji jest nieokreślony. |
UPDATE_STATE_NOT_STARTED |
Aktualizacja jest oczekująca, ale jeszcze się nie rozpoczęła. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Oczekująca aktualizacja jest pobierana. |
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 anulowania udostępnienia 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 zaktualizowane. |
DEPROVISION_REASON_DOMAIN_MOVE |
Zmieniono domenę urządzenia. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Usługa straciła ważność na urządzeniu. |
DEPROVISION_REASON_OTHER |
Urządzenie zostało wyrejestrowane z prywatnego powodu, który nie jest już obsługiwany. |
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 |
Nie wymagano uzasadnienia. 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że być ustawiony tylko przez centrum napraw 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 samodzielną, bezterminową licencję na Chrome Education. |
EDUCATION |
Urządzenie jest połączone z bezterminową licencją 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. Przydatne, jeśli dzwoniący musi powiązać je z innymi informacjami. |
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 systemu operacyjnego Chrome nie został określony. |
CHROME_OS_FLEX |
Typ systemu operacyjnego: Chrome OS Flex. |
CHROME_OS |
Typ ChromeOS: ChromeOS. |
ByteUsage
Reprezentuje pojemność danych z pewną ilością bieżącego wykorzystania w bajtach.
Zapis JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
Pola | |
---|---|
capacityBytes |
Tylko dane wyjściowe. Łączna wartość pojemności w bajtach. |
usedBytes |
Tylko dane wyjściowe. Bieżąca wartość wykorzystania w bajtach. |
Metody |
|
---|---|
(deprecated) |
Zamiast tego użyj polecenia BatchChangeChromeOsDeviceStatus. |
|
Pobiera właściwości urządzenia z Chrome OS. |
|
Pobiera ponumerowane listy urządzeń z Chrome OS na koncie. |
|
Przenosi lub wstawia wiele urządzeń z ChromeOS 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 . |