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 ( |
Felder | |
---|---|
deviceId |
Die eindeutige ID des Chrome-Geräts. |
serialNumber |
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 |
Der Status des Geräts. Akzeptable Werte sind:
|
lastSync |
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 |
supportEndDate |
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 |
annotatedUser |
Der Nutzer des Geräts, wie vom Administrator vermerkt. Die maximale Länge beträgt 100 Zeichen. Leere Werte sind zulässig. |
annotatedLocation |
Die Adresse oder der Standort des Geräts, wie vom Administrator vermerkt. Die maximale Länge beträgt |
notes |
Hinweise zu diesem Gerät wurden vom Administrator hinzugefügt. Diese Eigenschaft kann mit dem Parameter |
model |
Die Modellinformationen des Geräts. Wenn das Gerät diese Informationen nicht hat, ist diese Eigenschaft nicht in der Antwort enthalten. |
meid |
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 |
Die Bestellnummer des Geräts Nur Geräte, die direkt bei Google gekauft wurden, haben eine Bestellnummer. |
willAutoRenew |
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 |
Die Betriebssystemversion des Chrome-Geräts. |
platformVersion |
Die Plattformversion des Chrome-Geräts. |
firmwareVersion |
Die Firmwareversion des Chrome-Geräts. |
macAddress |
Die WLAN-MAC-Adresse des Geräts. Wenn das Gerät diese Informationen nicht hat, sind sie nicht in der Antwort enthalten. |
bootMode |
Der Bootmodus für das Gerät. Die möglichen Werte sind:
|
lastEnrollmentTime |
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 |
kind |
Der Ressourcentyp. Für die Ressource „Chromeosdevices“ ist der Wert |
recentUsers[] |
Eine Liste der Gerätenutzer, die zuletzt angemeldet waren, in absteigender Reihenfolge nach dem Zeitpunkt der letzten Anmeldung. |
recentUsers[].type |
Der Typ der Nutzenden. Akzeptable Werte sind:
|
recentUsers[].email |
Die E-Mail-Adresse des Nutzers. Dieses Feld ist nur vorhanden, wenn der Nutzertyp |
activeTimeRanges[] |
Eine Liste der aktiven Zeiträume (schreibgeschützt). |
activeTimeRanges[].activeTime |
Nutzungsdauer in Millisekunden. |
activeTimeRanges[].date |
Datum der Nutzung. |
ethernetMacAddress |
MAC-Adresse des Geräts an der Ethernet-Netzwerkschnittstelle. |
annotatedAssetId |
Die Geräte-ID, die von einem Administrator vermerkt oder bei der Registrierung angegeben wurde. |
etag |
Das ETag der Ressource. |
diskVolumeReports[] |
Berichte über Speicherplatz und andere Informationen über bereitgestellte/verbundene Volumes. |
diskVolumeReports[].volumeInfo[] |
Laufwerks-Volumes |
diskVolumeReports[].volumeInfo[].volumeId |
Volume-ID |
diskVolumeReports[].volumeInfo[].storageTotal |
Speicherplatz insgesamt [in Byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Freier Speicherplatz [in Byte] |
systemRamTotal |
RAM insgesamt auf dem Gerät in Byte |
cpuStatusReports[] |
Berichte zu CPU-Auslastung und -Temperatur (schreibgeschützt) |
cpuStatusReports[].reportTime |
Datum und Uhrzeit des Empfangs des Berichts |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Eine Liste mit CPU-Temperaturbeispielen. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatur in Celsius Grad. |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU-Label |
cpuInfo[] |
Informationen zu den CPU-Spezifikationen des Geräts. |
cpuInfo[].model |
Der Name des CPU-Modells. |
cpuInfo[].architecture |
Die CPU-Architektur. |
cpuInfo[].maxClockSpeedKhz |
Die maximale CPU-Taktgeschwindigkeit in kHz. |
cpuInfo[].logicalCpus[] |
Informationen zu den logischen CPUs |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Maximale Häufigkeit, mit der die CPU gemäß Richtlinie ausgeführt werden darf. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Aktuelle Frequenz, mit der die CPU ausgeführt wird. |
cpuInfo[].logicalCpus[].idleDuration |
Inaktivitätszeit seit dem letzten Start. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
cpuInfo[].logicalCpus[].cStates[] |
C-States zeigen den Stromverbrauch der CPU an. Weitere Informationen finden Sie in der vom CPU-Hersteller veröffentlichten Dokumentation. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Name des Bundeslands. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Zeit, die seit dem letzten Neustart im Status verbracht wurde. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
deviceFiles[] |
Eine Liste der herunterzuladenden Dateien auf dem Gerät (schreibgeschützt) |
deviceFiles[].name |
Dateiname |
deviceFiles[].type |
File type |
deviceFiles[].downloadUrl |
Download-URL für Datei |
deviceFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
systemRamFreeReports[] |
Berichte zum verfügbaren RAM-Arbeitsspeicher (schreibgeschützt) |
systemRamFreeReports[].reportTime |
Datum und Uhrzeit des Empfangs des Berichts |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Enthält das letzte bekannte Netzwerk (schreibgeschützt) |
lastKnownNetwork[].ipAddress |
Die IP-Adresse. |
lastKnownNetwork[].wanIpAddress |
Die WAN-IP-Adresse. |
autoUpdateExpiration |
(Lesezugriff) Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder -Support mehr erhält |
ethernetMacAddress0 |
(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 |
(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 |
(Schreibgeschützt) Das Herstellungsdatum des Geräts im Format JJJJ-MM-TT. |
orgUnitPath |
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 ( |
tpmVersionInfo |
Trusted Platform Module (TPM) (schreibgeschützt) |
tpmVersionInfo.family |
TPM-Familie. Wir verwenden die TPM 2.0-Stilcodierung, zum Beispiel: |
tpmVersionInfo.specLevel |
TPM-Spezifikationsebene. Siehe Bibliotheksspezifikation für TPM 2.0 und Hauptspezifikation für TPM 1.2. |
tpmVersionInfo.manufacturer |
TPM-Herstellercode. |
tpmVersionInfo.tpmModel |
TPM-Modellnummer. |
tpmVersionInfo.firmwareVersion |
TPM-Firmwareversion. |
tpmVersionInfo.vendorSpecific |
Anbieterspezifische Informationen wie die Anbieter-ID |
screenshotFiles[] |
Eine Liste der herunterladbaren Screenshot-Dateien. Der Typ ist immer "SCREENSHOT_FILE". (schreibgeschützt) |
screenshotFiles[].name |
Dateiname |
screenshotFiles[].type |
File type |
screenshotFiles[].downloadUrl |
Download-URL für Datei |
screenshotFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
orgUnitId |
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 |
Der Status der Betriebssystemupdates für das Gerät. |
firstEnrollmentTime |
Datum und Uhrzeit der ersten Registrierung des Geräts. |
lastDeprovisionTimestamp |
(schreibgeschützt) Datum und Uhrzeit der letzten Aufhebung der Bereitstellung des Geräts. |
deprovisionReason |
(Schreibgeschützt) Grund für die Aufhebung der Bereitstellung. |
deviceLicenseType |
Nur Ausgabe Gerätelizenztyp. |
backlightInfo[] |
Nur Ausgabe Enthält Informationen zur Hintergrundbeleuchtung des Geräts. |
OsUpdateStatus
Enthält Informationen zum aktuellen Status des Betriebssystemupdates.
JSON-Darstellung |
---|
{
"state": enum ( |
Felder | |
---|---|
state |
Der Updatestatus eines Betriebssystemupdates. |
targetOsVersion |
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 |
Neue erforderliche Plattformversion aus der ausstehenden aktualisierten Kiosk-App. |
updateTime |
Datum und Uhrzeit des letzten erfolgreichen Betriebssystemupdates. |
updateCheckTime |
Datum und Uhrzeit der letzten Updateprüfung. |
rebootTime |
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 |
Nur Ausgabe Pfad zu dieser Hintergrundbeleuchtung im System. Nützlich, wenn der Aufrufer mit anderen Informationen in Beziehung setzen muss. |
maxBrightness |
Nur Ausgabe Maximale Helligkeit der Hintergrundbeleuchtung. |
brightness |
Nur Ausgabe Aktuelle Helligkeit der Hintergrundbeleuchtung zwischen 0 und maxBrightness. |
Methoden |
|
---|---|
(deprecated) |
Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. |
|
Ruft die Eigenschaften eines Chrome OS-Geräts ab. |
|
Ruft eine paginierte Liste mit Chrome OS-Geräten innerhalb eines Kontos ab. |
|
Verschiebt oder fügt mehrere Chrome OS-Geräte in eine Organisationseinheit ein. |
|
Aktualisiert die aktualisierbaren Eigenschaften eines Geräts, z. B. annotatedUser , annotatedLocation , notes , orgUnitPath oder annotatedAssetId . |
|
Aktualisiert die aktualisierbaren Eigenschaften eines Geräts, z. B. annotatedUser , annotatedLocation , notes , orgUnitPath oder annotatedAssetId . |