REST Resource: chromeosdevices

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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
Pola
deviceId

string

Unikalny identyfikator urządzenia z Chrome.
serialNumber

string

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

string

Stan urządzenia.

Akceptowane wartości:

  • ACTIVE: urządzenie jest zarejestrowane w domenie.
  • DELINQUENT: roczna licencja dla domeny wygasła, a urządzenie nie otrzymuje już zasad ani ustawień. Po zakupie nowej licencji urządzenie wróci do stanu ACTIVE.
  • PRE_PROVISIONED: urządzenie zostało zarejestrowane w rejestracji typu zero-touch. Urządzenie PRE_PROVISIONED można przenieść do innej jednostki organizacyjnej lub usunąć. Po zakończeniu rejestracji urządzenie będzie ACTIVE.
  • DEPROVISIONED: urządzenia nie można już zarejestrować w domenie. Zamówienie zostało anulowane. Ustawienia urządzenia zostały zapisane w pamięci podręcznej. Jeśli urządzenie zostanie ponownie aktywowane, do nowo aktywowanego urządzenia zostaną zastosowane najnowsze ustawienia systemu.
  • DISABLED: urządzenie zostało wyłączone przez administratora i nie można go używać.
  • INACTIVE: urządzenie nie jest zarejestrowane w domenie.
  • RETURN_ARRIVED: przyszła prośba o wymianę tego urządzenia.
  • RETURN_REQUESTED: wysłano prośbę o zastąpienie tego urządzenia.
  • SHIPPED: urządzenie zostało wysłane z zasobów reklamowych Google. (Wycofane)
  • UNKNOWN: nie można określić stanu urządzenia.
lastSync

string

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 YYYY-MM-DDThh:mm:ssTZD. Na przykład: 2010-04-05T17:30:04+01:00.
supportEndDate

string

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 YYYY-MM-DDThh:mm:ssTZD. Na przykład: 2010-04-05T17:30:04+01:00.
annotatedUser

string

Użytkownik urządzenia wskazany przez administratora. Maksymalna długość to 100 znaków. Puste wartości są dozwolone.
annotatedLocation

string

Adres lub lokalizacja urządzenia zgodnie z danymi administratora. Maksymalna długość to 200 znaków. Puste wartości są dozwolone.
notes

string

Notatki na temat tego urządzenia dodane przez administratora. Tę właściwość można wyszukiwać za pomocą parametru query metody list. Maksymalna długość to 500 znaków. Puste wartości są dozwolone.
model

string

Informacje o modelu urządzenia. Jeśli urządzenie nie ma tych informacji, ta właściwość nie zostanie uwzględniona w odpowiedzi.
meid

string

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

string

Numer zamówienia urządzenia. Tylko urządzenia kupione bezpośrednio od Google mają numer zamówienia.
willAutoRenew

boolean

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

string

Wersja systemu operacyjnego urządzenia z Chrome.
platformVersion

string

Wersja platformy urządzenia z Chrome.
firmwareVersion

string

Wersja oprogramowania układowego urządzenia z Chrome.
macAddress

string

Adres MAC urządzenia bezprzewodowego. Jeśli na urządzeniu nie ma tych informacji, odpowiedź nie zostanie uwzględniona.
bootMode

string

Tryb uruchamiania urządzenia. Możliwe wartości to:

  • Verified: na urządzeniu jest zainstalowana prawidłowa wersja systemu operacyjnego Chrome.
  • Dev: przełącznik sprzętowy urządzenia jest włączony. Po uruchomieniu urządzenie ma powłokę wiersza poleceń. Przykład przełącznika programisty znajdziesz w informacjach dla deweloperów Chromebooków.
lastEnrollmentTime

string

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 YYYY-MM-DDThh:mm:ssTZD. Na przykład: 2010-04-05T17:30:04+01:00. Więcej informacji o rejestracji automatycznej i ręcznej znajdziesz w Centrum pomocy Chrome.
kind

string

Typ zasobu. W przypadku zasobu Chromeosdevices wartość to admin#directory#chromeosdevice.
recentUsers[]

object

Lista ostatnich użytkowników urządzenia w kolejności malejącej według czasu ostatniego logowania.
recentUsers[].type

string

Typ użytkownika.

Akceptowane wartości:

  • USER_TYPE_MANAGED: użytkownik jest zarządzany przez domenę.
  • USER_TYPE_UNMANAGED: użytkownik nie jest zarządzany przez domenę.
recentUsers[].email

string

Adres e-mail użytkownika. Ta wartość występuje tylko wtedy, gdy typ użytkownika to USER_TYPE_MANAGED.
activeTimeRanges[]

object

Lista aktywnych zakresów czasu (tylko do odczytu).
activeTimeRanges[].activeTime

integer

Czas użycia w milisekundach.
activeTimeRanges[].date

string

Data użycia.
ethernetMacAddress

string

Adres MAC urządzenia w interfejsie sieci Ethernet.
annotatedAssetId

string

Identyfikator zasobu podany przez administratora lub podany podczas rejestracji.
etag

string

ETag zasobu.
diskVolumeReports[]

object

Raporty o miejscu na dysku i inne informacje o podłączonych/połączonych woluminach.
diskVolumeReports[].volumeInfo[]

object

Woluminy dysku
diskVolumeReports[].volumeInfo[].volumeId

string

Identyfikator woluminu
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Całkowita ilość miejsca na dysku [w bajtach]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Wolne miejsce na dysku [w bajtach]
systemRamTotal

string (int64 format)

Łączna ilość pamięci RAM na urządzeniu w bajtach
cpuStatusReports[]

object

Raporty o wykorzystaniu i temperaturze procesora (tylko do odczytu)
cpuStatusReports[].reportTime

string

Data i godzina otrzymania raportu.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Lista próbek temperatury procesora.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatura w stopniach Celsjusza.
cpuStatusReports[].cpuTemperatureInfo[].label

string

Etykieta procesora
cpuInfo[]

object

Informacje o danych technicznych procesora urządzenia.
cpuInfo[].model

string

Nazwa modelu procesora.
cpuInfo[].architecture

string

Architektura procesora.
cpuInfo[].maxClockSpeedKhz

integer

Maksymalna częstotliwość zegara procesora w kHz.
cpuInfo[].logicalCpus[]

object

Informacje o procesorach logicznych
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Maksymalna częstotliwość, z jaką procesor może działać, według zasady.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Bieżąca częstotliwość, z jaką działa procesor.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Czas bezczynności od ostatniego uruchomienia.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

Wartości C wskazują stan zużycia energii przez procesor. Więcej informacji znajdziesz w dokumentacji opublikowanej przez producenta procesora.
cpuInfo[].logicalCpus[].cStates[].displayName

string

Nazwa stanu.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

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 „s”. Przykład: "3.5s".
deviceFiles[]

object

Lista plików na urządzeniu do pobrania (tylko do odczytu)
deviceFiles[].name

string

Nazwa pliku
deviceFiles[].type

string

Typ pliku
deviceFiles[].downloadUrl

string

Adres URL pobierania pliku
deviceFiles[].createTime

string

Data i godzina utworzenia pliku
systemRamFreeReports[]

object

Raporty o ilości dostępnej pamięci RAM (tylko do odczytu)
systemRamFreeReports[].reportTime

string

Data i godzina otrzymania raportu.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Zawiera ostatnią znaną sieć (tylko do odczytu)
lastKnownNetwork[].ipAddress

string

Adres IP.
lastKnownNetwork[].wanIpAddress

string

Adres IP w sieci WAN.
autoUpdateExpiration

string (int64 format)

(Tylko do odczytu) Sygnatura czasowa, po której urządzenie przestanie otrzymywać aktualizacje Chrome lub nie będzie obsługiwać obsługi.
ethernetMacAddress0

string

(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

string

(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

string

(Tylko do odczytu) Data produkcji urządzenia w formacie rrrr-mm-dd.
orgUnitPath

string

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: /. 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.
tpmVersionInfo

object

TPM (Trusted Platform Module) (tylko do odczytu)
tpmVersionInfo.family

string

Rodzina TPM. Używamy kodowania TPM 2.0, np.:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2,0" -> 322e3000
tpmVersionInfo.specLevel

string

Poziom specyfikacji TPM. Patrz: specyfikacja biblioteki dotycząca TPM 2.0 i główna specyfikacja dla TPM 1.2.
tpmVersionInfo.manufacturer

string

Kod producenta TPM.
tpmVersionInfo.tpmModel

string

Numer modelu TPM.
tpmVersionInfo.firmwareVersion

string

Wersja oprogramowania TPM.
tpmVersionInfo.vendorSpecific

string

informacje o poszczególnych dostawcach, np. identyfikator dostawcy;
screenshotFiles[]

object

Lista plików ze zrzutami ekranu do pobrania. Typ to zawsze „SCREENSHOT_FILE”. (Tylko do odczytu)
screenshotFiles[].name

string

Nazwa pliku
screenshotFiles[].type

string

Typ pliku
screenshotFiles[].downloadUrl

string

Adres URL pobierania pliku
screenshotFiles[].createTime

string

Data i godzina utworzenia pliku
orgUnitId

string

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

object (OsUpdateStatus)

Stan aktualizacji systemu operacyjnego urządzenia.
firstEnrollmentTime

string

Data i godzina pierwszej rejestracji urządzenia.
lastDeprovisionTimestamp

string

(Tylko do odczytu) Data i godzina ostatniego wyrejestrowania urządzenia.
deprovisionReason

enum (DeprovisionReason)

(Tylko do odczytu) Przyczyna wyrejestrowania.
deviceLicenseType

enum (DeviceLicenseType)

Tylko dane wyjściowe. Typ licencji urządzenia.
backlightInfo[]

object (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 (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Pola
state

enum (UpdateState)

Stan aktualizacji systemu operacyjnego.
targetOsVersion

string

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

string

Nowa wymagana wersja platformy z oczekującej zaktualizowanej aplikacji kiosku.
updateTime

string

Data i godzina ostatniej udanej aktualizacji systemu operacyjnego.
updateCheckTime

string

Data i godzina ostatniego sprawdzenia dostępności aktualizacji.
rebootTime

string

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

string

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

integer

Tylko dane wyjściowe. Maksymalna jasność podświetlenia.
brightness

integer

Tylko dane wyjściowe. Bieżąca jasność podświetlenia: od 0 do maksymalnej jasności.

Metody

action
(deprecated)

 Użyj w zamian BatchChangeChromeOsDeviceStatus.

get

 Pobiera właściwości urządzenia z Chrome OS.

list

 Pobiera listę urządzeń z Chrome OS podzieloną na strony w ramach konta.

moveDevicesToOu

 Przenosi lub wstawia wiele urządzeń z Chrome OS do jednostki organizacyjnej.

patch

 Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.

update

 Aktualizuje właściwości urządzenia, które można zaktualizować, takie jak annotatedUser, annotatedLocation, notes, orgUnitPath lub annotatedAssetId.