REST Resource: chromeosdevices

Ressource: ChromeOsDevice

Google Chrome-Geräte laufen unter Chrome OS. Weitere Informationen zu gängigen API-Aufgaben finden Sie im Entwicklerhandbuch.

JSON-Darstellung 
{
  "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)
    }
  ]
}
Felder
deviceId

string

Die eindeutige ID des Chrome-Geräts.
serialNumber

string

Die Seriennummer des Chrome-Geräts, die bei der Aktivierung des Geräts eingegeben wurde. Dieser Wert entspricht der Seriennummer der Admin-Konsole auf dem Tab Chrome OS-Geräte.
status

string

Der Status des Geräts.

Akzeptable Werte sind:

  • ACTIVE: Das Gerät ist in der Domain registriert.
  • DELINQUENT: Die Jahreslizenz für die Domain ist abgelaufen und das Gerät erhält keine Richtlinien und Einstellungen mehr. Wenn eine neue Lizenz erworben wird, wird das Gerät in den Status „ACTIVE“ zurückversetzt.
  • PRE_PROVISIONED: Das Gerät wurde für die Zero-Touch-Registrierung registriert. Ein PRE_PROVISIONED-Gerät kann in eine andere Organisationseinheit verschoben oder gelöscht werden. Nach Abschluss der Registrierung erhält das Gerät den Status „ACTIVE“.
  • DEPROVISIONED: Das Gerät kann nicht mehr in der Domain registriert werden. Die Bestellung wurde storniert. Die Einstellungen des Geräts wurden auf dem Gerät im Cache gespeichert. Wenn das Gerät wieder aktiviert wird, werden die neuesten Systemeinstellungen auf dieses neu aktivierte Gerät angewendet.
  • DISABLED: Das Gerät wurde vom Administrator deaktiviert und kann nicht verwendet werden.
  • INACTIVE: Das Gerät ist nicht in der Domain registriert.
  • RETURN_ARRIVED: Die Anfrage zum Ersetzen dieses Geräts ist eingegangen.
  • RETURN_REQUESTED: Es wurde eine Anfrage zum Ersetzen dieses Geräts gesendet.
  • SHIPPED: Das Gerät wird aus Google-Inventar versendet. (Verworfen)
  • UNKNOWN: Der Status des Geräts kann nicht ermittelt werden.
lastSync

string

Zeitpunkt (Datum und Uhrzeit), zu dem das Gerät zuletzt mit den Richtlinieneinstellungen in der Admin-Konsole synchronisiert wurde. Der Wert hat das Datums- und Uhrzeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum mit Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00
supportEndDate

string

Das Datum, ab dem das Gerät unterstützt wird. Dies gilt nur für Geräte, die direkt bei Google gekauft wurden. Der Wert hat das Datums- und Uhrzeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum mit Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00
annotatedUser

string

Der Nutzer des Geräts, wie vom Administrator vermerkt. Die maximale Länge beträgt 100 Zeichen. Leere Werte sind zulässig.
annotatedLocation

string

Die Adresse oder der Standort des Geräts, wie vom Administrator vermerkt. Die maximale Länge beträgt 200 Zeichen. Leere Werte sind zulässig.
notes

string

Hinweise zu diesem Gerät wurden vom Administrator hinzugefügt. Diese Eigenschaft kann mit dem Parameter query der list-Methode gesucht werden. Maximale Länge: 500 Zeichen Leere Werte sind zulässig.
model

string

Die Modellinformationen des Geräts. Wenn das Gerät diese Informationen nicht hat, ist diese Eigenschaft nicht in der Antwort enthalten.
meid

string

Die Mobile Equipment Identifier (MEID) oder die International Mobile Equipment Identity (IMEI) für die 3G-Mobilfunkkarte in einem Mobilgerät. Eine MEID/IMEI wird in der Regel verwendet, wenn ein Gerät dem Postpay-Serviceplan eines Mobilfunkanbieters hinzugefügt wird. Wenn das Gerät diese Informationen nicht hat, ist diese Eigenschaft nicht in der Antwort enthalten. Weitere Informationen zum Exportieren einer MEID/IMEI-Liste finden Sie im Entwicklerhandbuch.
orderNumber

string

Die Bestellnummer des Geräts Nur Geräte, die direkt bei Google gekauft wurden, haben eine Bestellnummer.
willAutoRenew

boolean

Legt fest, ob der Support für das Gerät nach dem Enddatum des Supports automatisch verlängert wird. Diese Property ist schreibgeschützt.
osVersion

string

Die Betriebssystemversion des Chrome-Geräts.
platformVersion

string

Die Plattformversion des Chrome-Geräts.
firmwareVersion

string

Die Firmwareversion des Chrome-Geräts.
macAddress

string

Die WLAN-MAC-Adresse des Geräts. Wenn das Gerät diese Informationen nicht hat, sind sie nicht in der Antwort enthalten.
bootMode

string

Der Bootmodus für das Gerät. Die möglichen Werte sind:

  • Verified: Auf dem Gerät wird eine gültige Version von Chrome OS ausgeführt.
  • Dev: Der Hardwareschalter des Geräts ist aktiviert. Beim Starten verfügt das Gerät über eine Befehlszeilen-Shell. Ein Beispiel für einen Entwicklerwechsel finden Sie in den Informationen für Chromebook-Entwickler.
lastEnrollmentTime

string

Datum und Uhrzeit der letzten Registrierung des Geräts. Der Wert hat das Datums- und Uhrzeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum mit Stunden, Minuten und Sekunden im Format YYYY-MM-DDThh:mm:ssTZD. Beispiel: 2010-04-05T17:30:04+01:00 Weitere Informationen zur automatischen und manuellen Registrierung finden Sie in der Chrome-Hilfe.
kind

string

Der Ressourcentyp. Für die Ressource „Chromeosdevices“ ist der Wert admin#directory#chromeosdevice.
recentUsers[]

object

Eine Liste der Gerätenutzer, die zuletzt angemeldet waren, in absteigender Reihenfolge nach dem Zeitpunkt der letzten Anmeldung.
recentUsers[].type

string

Der Typ der Nutzenden.

Akzeptable Werte sind:

  • USER_TYPE_MANAGED: Der Nutzer wird von der Domain verwaltet.
  • USER_TYPE_UNMANAGED: Der Nutzer wird nicht von der Domain verwaltet.
recentUsers[].email

string

Die E-Mail-Adresse des Nutzers. Dieses Feld ist nur vorhanden, wenn der Nutzertyp USER_TYPE_MANAGED ist.
activeTimeRanges[]

object

Eine Liste der aktiven Zeiträume (schreibgeschützt).
activeTimeRanges[].activeTime

integer

Nutzungsdauer in Millisekunden.
activeTimeRanges[].date

string

Datum der Nutzung.
ethernetMacAddress

string

MAC-Adresse des Geräts an der Ethernet-Netzwerkschnittstelle.
annotatedAssetId

string

Die Geräte-ID, die von einem Administrator vermerkt oder bei der Registrierung angegeben wurde.
etag

string

Das ETag der Ressource.
diskVolumeReports[]

object

Berichte über Speicherplatz und andere Informationen über bereitgestellte/verbundene Volumes.
diskVolumeReports[].volumeInfo[]

object

Laufwerks-Volumes
diskVolumeReports[].volumeInfo[].volumeId

string

Volume-ID
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Speicherplatz insgesamt [in Byte]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Freier Speicherplatz [in Byte]
systemRamTotal

string (int64 format)

RAM insgesamt auf dem Gerät in Byte
cpuStatusReports[]

object

Berichte zu CPU-Auslastung und -Temperatur (schreibgeschützt)
cpuStatusReports[].reportTime

string

Datum und Uhrzeit des Empfangs des Berichts
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Eine Liste mit CPU-Temperaturbeispielen.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatur in Celsius Grad.
cpuStatusReports[].cpuTemperatureInfo[].label

string

CPU-Label
cpuInfo[]

object

Informationen zu den CPU-Spezifikationen des Geräts.
cpuInfo[].model

string

Der Name des CPU-Modells.
cpuInfo[].architecture

string

Die CPU-Architektur.
cpuInfo[].maxClockSpeedKhz

integer

Die maximale CPU-Taktgeschwindigkeit in kHz.
cpuInfo[].logicalCpus[]

object

Informationen zu den logischen CPUs
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Maximale Häufigkeit, mit der die CPU gemäß Richtlinie ausgeführt werden darf.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Aktuelle Frequenz, mit der die CPU ausgeführt wird.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Inaktivitätszeit seit dem letzten Start.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

C-States zeigen den Stromverbrauch der CPU an. Weitere Informationen finden Sie in der vom CPU-Hersteller veröffentlichten Dokumentation.
cpuInfo[].logicalCpus[].cStates[].displayName

string

Name des Bundeslands.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Zeit, die seit dem letzten Neustart im Status verbracht wurde.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
deviceFiles[]

object

Eine Liste der herunterzuladenden Dateien auf dem Gerät (schreibgeschützt)
deviceFiles[].name

string

Dateiname
deviceFiles[].type

string

File type
deviceFiles[].downloadUrl

string

Download-URL für Datei
deviceFiles[].createTime

string

Datum und Uhrzeit der Dateierstellung
systemRamFreeReports[]

object

Berichte zum verfügbaren RAM-Arbeitsspeicher (schreibgeschützt)
systemRamFreeReports[].reportTime

string

Datum und Uhrzeit des Empfangs des Berichts
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Enthält das letzte bekannte Netzwerk (schreibgeschützt)
lastKnownNetwork[].ipAddress

string

Die IP-Adresse.
lastKnownNetwork[].wanIpAddress

string

Die WAN-IP-Adresse.
autoUpdateExpiration

string (int64 format)

(Lesezugriff) Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder -Support mehr erhält
ethernetMacAddress0

string

(schreibgeschützt) MAC-Adresse, die vom internen Ethernet-Port des Chromebooks und für die Ethernet-Schnittstelle verwendet wird. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Dies ist nur für einige Geräte relevant.
dockMacAddress

string

(Lesezugriff) Integrierte MAC-Adresse für die Dockingstation, mit der das Gerät verbunden ist. Über die Werkseinstellung wird die Steueradresse für den Medienzugriff (MAC-Adresse) festgelegt, die durch ein Dock verwendet werden kann. Sie ist speziell für die MAC-Passthrough-Geräterichtlinie reserviert. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Dies ist nur für einige Geräte relevant.
manufactureDate

string

(Schreibgeschützt) Das Herstellungsdatum des Geräts im Format JJJJ-MM-TT.
orgUnitPath

string

Der vollständige übergeordnete Pfad mit dem Namen der Organisationseinheit, der dem Gerät zugeordnet ist. Bei Pfadnamen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn die übergeordnete Organisationseinheit die oberste Organisation ist, wird sie durch einen Schrägstrich (/) dargestellt. Diese Eigenschaft kann mithilfe der API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Hilfe für Administratoren.
tpmVersionInfo

object

Trusted Platform Module (TPM) (schreibgeschützt)
tpmVersionInfo.family

string

TPM-Familie. Wir verwenden die TPM 2.0-Stilcodierung, zum Beispiel:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

TPM-Spezifikationsebene. Siehe Bibliotheksspezifikation für TPM 2.0 und Hauptspezifikation für TPM 1.2.
tpmVersionInfo.manufacturer

string

TPM-Herstellercode.
tpmVersionInfo.tpmModel

string

TPM-Modellnummer.
tpmVersionInfo.firmwareVersion

string

TPM-Firmwareversion.
tpmVersionInfo.vendorSpecific

string

Anbieterspezifische Informationen wie die Anbieter-ID
screenshotFiles[]

object

Eine Liste der herunterladbaren Screenshot-Dateien. Der Typ ist immer "SCREENSHOT_FILE". (schreibgeschützt)
screenshotFiles[].name

string

Dateiname
screenshotFiles[].type

string

File type
screenshotFiles[].downloadUrl

string

Download-URL für Datei
screenshotFiles[].createTime

string

Datum und Uhrzeit der Dateierstellung
orgUnitId

string

Die eindeutige ID der Organisationseinheit. orgUnitPath ist die visuell lesbare Version von orgUnitId. Während sich „orgUnitPath“ ändern kann, wenn eine Organisationseinheit im Pfad umbenannt wird, kann „orgUnitId“ für eine Organisationseinheit nicht geändert werden. Diese Eigenschaft kann mithilfe der API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Hilfe für Administratoren.
osUpdateStatus

object (OsUpdateStatus)

Der Status der Betriebssystemupdates für das Gerät.
firstEnrollmentTime

string

Datum und Uhrzeit der ersten Registrierung des Geräts.
lastDeprovisionTimestamp

string

(schreibgeschützt) Datum und Uhrzeit der letzten Aufhebung der Bereitstellung des Geräts.
deprovisionReason

enum (DeprovisionReason)

(Schreibgeschützt) Grund für die Aufhebung der Bereitstellung.
deviceLicenseType

enum (DeviceLicenseType)

Nur Ausgabe Gerätelizenztyp.
backlightInfo[]

object (BacklightInfo)

Nur Ausgabe Enthält Informationen zur Hintergrundbeleuchtung des Geräts.

OsUpdateStatus

Enthält Informationen zum aktuellen Status des Betriebssystemupdates.

JSON-Darstellung 
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Felder
state

enum (UpdateState)

Der Updatestatus eines Betriebssystemupdates.
targetOsVersion

string

Neue Plattformversion des Betriebssystem-Images, das heruntergeladen und angewendet wird. Sie wird nur festgelegt, wenn der Update-Status UPDATE_STATUS_DOWNLOAD_IN_PROGRESS oder UPDATE_STATUS_NEED_REBOOT ist. Beachten Sie, dass dies in einigen Grenzfällen als Dummy-Wert "0.0.0.0" für UPDATE_STATUS_NEED_REBOOT verwendet werden kann, z.B. wenn die Update-Engine ohne Neustart neu gestartet wird.
targetKioskAppVersion

string

Neue erforderliche Plattformversion aus der ausstehenden aktualisierten Kiosk-App.
updateTime

string

Datum und Uhrzeit des letzten erfolgreichen Betriebssystemupdates.
updateCheckTime

string

Datum und Uhrzeit der letzten Updateprüfung.
rebootTime

string

Datum und Uhrzeit des letzten Neustarts.

UpdateState

Der Updatestatus eines Betriebssystemupdates.

Enums
UPDATE_STATE_UNSPECIFIED Der Aktualisierungsstatus ist nicht angegeben.
UPDATE_STATE_NOT_STARTED Ein Update steht aus, hat aber noch nicht begonnen.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS Das ausstehende Update wird heruntergeladen.
UPDATE_STATE_NEED_REBOOT Das Gerät ist zur Installation des Updates bereit, muss jedoch neu gestartet werden.

DeprovisionReason

Der Grund für die Aufhebung der Bereitstellung eines ChromeOS-Geräts.

Enums
DEPROVISION_REASON_UNSPECIFIED Der Grund für das Aufheben der Bereitstellung ist unbekannt.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT Ersetzt durch dasselbe Modell. Sie haben einen Rücksendeschein (RMA) oder möchten ein fehlerhaftes Gerät im Rahmen der Gewährleistung durch dasselbe Gerätemodell ersetzen.
DEPROVISION_REASON_UPGRADE

Das Gerät wurde aktualisiert.
DEPROVISION_REASON_DOMAIN_MOVE

Die Domain des Geräts wurde geändert.
DEPROVISION_REASON_SERVICE_EXPIRATION

Der Dienst ist für das Gerät abgelaufen.
DEPROVISION_REASON_OTHER

Die Bereitstellung des Geräts wurde aus einem Grund aufgehoben, der in der Vergangenheit nicht mehr unterstützt wird.
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT Ersetzt durch anderes Modell. Sie möchten das Gerät durch ein neueres Gerätemodell oder ein neueres Gerätemodell ersetzen.
DEPROVISION_REASON_RETIRING_DEVICE Wird aus Flotte entfernt. Sie möchten das Gerät spenden, entsorgen oder die Nutzung anderweitig einstellen.
DEPROVISION_REASON_UPGRADE_TRANSFER Übertragung von ChromeOS Flex-Upgrades. Dies ist ein ChromeOS Flex-Gerät, das Sie innerhalb eines Jahres durch ein Chromebook ersetzen möchten.
DEPROVISION_REASON_NOT_REQUIRED Es wurde kein Grund angegeben. Beispiel: Die Lizenzen wurden an den Lizenzpool des Kunden zurückgegeben.
DEPROVISION_REASON_REPAIR_CENTER Die Bereitstellung des Geräts wurde vom Reparaturservicecenter aufgehoben. Kann nur während der RMA vom Reparaturservicecenter festgelegt werden.

DeviceLicenseType

Der Lizenztyp dieses Geräts.

Enums
DEVICE_LICENSE_TYPE_UNSPECIFIED Der Lizenztyp ist unbekannt.
ENTERPRISE Das Gerät wird zusammen mit einem unbefristeten Chrome Enterprise-Upgrade ausgeliefert.
ENTERPRISE_UPGRADE Sie erhalten ein jährliches eigenständiges Chrome Enterprise-Upgrade.
EDUCATION_UPGRADE Das Gerät verfügt über ein unbefristetes, eigenständiges Chrome Education-Upgrade.
EDUCATION Das Gerät wird zusammen mit einem unbefristeten Chrome Education-Upgrade ausgeliefert.
KIOSK_UPGRADE Das Gerät erhält ein jährliches Kiosk-Upgrade.

BacklightInfo

Informationen zu den Hintergrundbeleuchtung des Geräts.

JSON-Darstellung 
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Felder
path

string

Nur Ausgabe Pfad zu dieser Hintergrundbeleuchtung im System. Nützlich, wenn der Aufrufer mit anderen Informationen in Beziehung setzen muss.
maxBrightness

integer

Nur Ausgabe Maximale Helligkeit der Hintergrundbeleuchtung.
brightness

integer

Nur Ausgabe Aktuelle Helligkeit der Hintergrundbeleuchtung zwischen 0 und maxBrightness.

Methoden

action
(deprecated)

 Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus.

get

 Ruft die Eigenschaften eines Chrome OS-Geräts ab.

list

 Ruft eine paginierte Liste mit Chrome OS-Geräten innerhalb eines Kontos ab.

moveDevicesToOu

 Verschiebt oder fügt mehrere Chrome OS-Geräte in eine Organisationseinheit ein.

patch

 Aktualisiert die aktualisierbaren Eigenschaften eines Geräts, z. B. annotatedUser, annotatedLocation, notes, orgUnitPath oder annotatedAssetId.

update

 Aktualisiert die aktualisierbaren Eigenschaften eines Geräts, z. B. annotatedUser, annotatedLocation, notes, orgUnitPath oder annotatedAssetId.