Ressource: ChromeOsDevice
Google Chrome-Geräte nutzen das Betriebssystem ChromeOS. Weitere Informationen zu gängigen API-Aufgaben finden Sie im Entwicklerleitfaden.
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 beim Aktivieren des Geräts eingegeben wurde. Dieser Wert entspricht der Seriennummer in der Admin-Konsole auf dem Tab ChromeOS-Geräte. |
status |
Der Status des Geräts. Akzeptable Werte sind:
|
lastSync |
Datum und Uhrzeit, an dem das Gerät zuletzt mit den Richtlinieneinstellungen in der Admin-Konsole synchronisiert wurde. Der Wert ist im Datums- und Zeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
supportEndDate |
Das Datum, an dem die Unterstützung für das Gerät endet. Dies gilt nur für Geräte, die direkt bei Google gekauft wurden. Der Wert ist im Datums- und Zeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
annotatedUser |
Der vom Administrator angegebene Nutzer des Geräts. Die maximale Länge beträgt 100 Zeichen. Leere Werte sind zulässig. |
annotatedLocation |
Die vom Administrator angegebene Adresse oder der vom Administrator angegebene Standort des Geräts. Die maximale Länge beträgt |
notes |
Vom Administrator hinzugefügte Hinweise zu diesem Gerät. 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 Postpaid-Tarif 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 Entwicklerleitfaden. |
orderNumber |
Die Bestellnummer des Geräts. Nur Geräte, die direkt bei Google gekauft wurden, haben eine Bestellnummer. |
willAutoRenew |
Gibt an, ob der Support für das Gerät nach dem Enddatum automatisch verlängert wird. Diese Eigenschaft 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 MAC-Adresse des Geräts. Wenn das Gerät diese Informationen nicht hat, werden sie nicht in die Antwort aufgenommen. |
bootMode |
Der Bootmodus des Geräts. Die möglichen Werte sind:
|
lastEnrollmentTime |
Datum und Uhrzeit der letzten Registrierung des Geräts. Der Wert ist im Datums- und Zeitformat ISO 8601. Die Uhrzeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
kind |
Der Ressourcentyp. Für die Chromeosdevices-Ressource ist der Wert |
recentUsers[] |
Eine Liste der letzten Gerätenutzer in absteigender Reihenfolge nach der letzten Anmeldung. |
recentUsers[].type |
Der Nutzertyp. Akzeptable Werte sind:
|
recentUsers[].email |
Die E-Mail-Adresse des Nutzers. Dieser Wert ist nur vorhanden, wenn der Nutzertyp |
activeTimeRanges[] |
Liste der aktiven Zeiträume (schreibgeschützt) |
activeTimeRanges[].activeTime |
Dauer der Nutzung in Millisekunden. |
activeTimeRanges[].date |
Datum der Nutzung. |
ethernetMacAddress |
Die MAC-Adresse des Geräts an der Ethernet-Netzwerkschnittstelle. |
annotatedAssetId |
Die Asset-ID, wie vom Administrator oder bei der Registrierung angegeben. |
etag |
ETag der Ressource. |
diskVolumeReports[] |
Berichte zum Speicherplatz und andere Informationen zu bereitgestellten/verbundenen Volumes. |
diskVolumeReports[].volumeInfo[] |
Laufwerkvolumes |
diskVolumeReports[].volumeInfo[].volumeId |
Volume-ID |
diskVolumeReports[].volumeInfo[].storageTotal |
Gesamtspeicherplatz [in Byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Freier Speicherplatz [in Byte] |
systemRamTotal |
Gesamter RAM auf dem Gerät in Byte |
cpuStatusReports[] |
Berichte zur CPU-Auslastung und -Temperatur (Lesezugriff) |
cpuStatusReports[].reportTime |
Datum und Uhrzeit des Eingangs der Meldung. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Eine Liste mit CPU-Temperaturproben. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatur in Grad Celsius. |
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 |
Die maximale Taktfrequenz, mit der die CPU gemäß Richtlinie laufen darf. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Die aktuelle Taktfrequenz der CPU. |
cpuInfo[].logicalCpus[].idleDuration |
Inaktivitätszeit seit dem letzten Start. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
cpuInfo[].logicalCpus[].cStates[] |
C-Status geben den Stromverbrauchsstatus der CPU an. Weitere Informationen finden Sie in der vom CPU-Hersteller veröffentlichten Dokumentation. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Name des Bundesstaats. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Die Zeit, die seit dem letzten Neustart in diesem Status verstrichen ist. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
deviceFiles[] |
Liste der herunterzuladenden Gerätedateien (schreibgeschützt) |
deviceFiles[].name |
Dateiname |
deviceFiles[].type |
Dateityp |
deviceFiles[].downloadUrl |
URL für den Dateidownload |
deviceFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
systemRamFreeReports[] |
Berichte zum verfügbaren RAM-Speicher (schreibgeschützt) |
systemRamFreeReports[].reportTime |
Datum und Uhrzeit des Eingangs der Meldung. |
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. Verwenden Sie stattdessen „autoUpdateThrough“. |
ethernetMacAddress0 |
(Lesezugriff) MAC-Adresse, die vom internen Ethernet-Port des Chromebooks und für die Onboard-Netzwerkschnittstelle (Ethernet) verwendet wird. Das Format besteht aus zwölf (12) Hexadezimalstellen ohne Trennzeichen (Großbuchstaben). Das ist nur für einige Geräte relevant. |
dockMacAddress |
(Lesezugriff) Die MAC-Adresse der Dockingstation, mit der das Gerät verbunden ist. Die werkseitig festgelegte MAC-Adresse (Media Access Control) für ein Dock. Er ist speziell für die MAC-Passthrough-Geräterichtlinie reserviert. Das Format besteht aus zwölf (12) Hexadezimalstellen ohne Trennzeichen (Großbuchstaben). Das ist nur für einige Geräte relevant. |
manufactureDate |
(Lesezugriff) Das Herstellungsdatum des Geräts im Format JJJJ-MM-TT. |
orgUnitPath |
Der vollständige übergeordnete Pfad mit dem Namen der Organisationseinheit, die mit dem Gerät verknüpft ist. Bei Pfadnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn die übergeordnete Organisationseinheit die oberste Organisationsebene ist, wird sie durch einen Schrägstrich |
tpmVersionInfo |
Trusted Platform Module (TPM) (schreibgeschützt) |
tpmVersionInfo.family |
TPM-Familie. Wir verwenden die TPM 2.0-Codierung, z.B.: |
tpmVersionInfo.specLevel |
TPM-Spezifikationsebene. Weitere Informationen finden Sie in der Bibliotheksspezifikation für TPM 2.0 und in der 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 Screenshotdateien. Der Typ ist immer „SCREENSHOT_FILE“. (schreibgeschützt) |
screenshotFiles[].name |
Dateiname |
screenshotFiles[].type |
Dateityp |
screenshotFiles[].downloadUrl |
URL für den Dateidownload |
screenshotFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
orgUnitId |
Die eindeutige ID der Organisationseinheit. „orgUnitPath“ ist die visuell lesbare Version von „orgUnitId“. Der Wert für „orgUnitPath“ kann sich ändern, wenn eine Organisationseinheit im Pfad umbenannt wird. „orgUnitId“ ist für eine Organisationseinheit jedoch unveränderlich. Dieses Attribut kann mithilfe der API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Verwaltungshilfe. |
osUpdateStatus |
Der Status der Betriebssystemupdates für das Gerät. |
firstEnrollmentTime |
Datum und Uhrzeit der ersten Registrierung des Geräts. |
lastDeprovisionTimestamp |
(Lesezugriff) Datum und Uhrzeit der letzten Deaktivierung des Geräts. |
deprovisionReason |
(Lesezugriff) Grund für die Aufhebung der Bereitstellung. |
deviceLicenseType |
Nur Ausgabe. Gerätelizenztyp |
backlightInfo[] |
Nur Ausgabe. Enthält Informationen zur Hintergrundbeleuchtung des Geräts. |
autoUpdateThrough |
Nur Ausgabe. Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder -Support mehr erhält. |
extendedSupportEligible |
Nur Ausgabe. Gibt an, ob für das Gerät der erweiterte Support aktiviert werden muss. |
extendedSupportStart |
Nur Ausgabe. Datum des Geräts, an dem die Richtlinie für erweiterten Support für automatische Updates beginnt. |
extendedSupportEnabled |
Nur Ausgabe. Gibt an, ob die Richtlinie für den erweiterten Support auf dem Gerät aktiviert ist. |
fanInfo[] |
Nur Ausgabe. Informationen zum Lüfter des Geräts. |
chromeOsType |
Nur Ausgabe. ChromeOS-Typ des Geräts. |
diskSpaceUsage |
Nur Ausgabe. Verfügbarer und aktuell belegter Festplattenspeicher des Geräts. |
OsUpdateStatus
Enthält Informationen zum aktuellen Update-Status des Betriebssystems.
JSON-Darstellung |
---|
{
"state": enum ( |
Felder | |
---|---|
state |
Der Updatestatus eines Betriebssystemupdates. |
targetOsVersion |
Neue Plattformversion des heruntergeladenen und angewendeten Betriebssystem-Images. Sie wird nur festgelegt, wenn der Updatestatus UPDATE_STATUS_DOWNLOAD_IN_PROGRESS oder UPDATE_STATUS_NEED_REBOOT ist. Hinweis: In einigen Grenzfällen kann dies ein Dummy „0.0.0.0“ für UPDATE_STATUS_NEED_REBOOT sein, z.B. wenn die Update-Engine ohne Neustart neu gestartet wird. |
targetKioskAppVersion |
Neue erforderliche Plattformversion aus der ausstehenden Aktualisierung der 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 Updatestatus ist nicht angegeben. |
UPDATE_STATE_NOT_STARTED |
Es steht ein Update aus, das aber noch nicht gestartet wurde. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Das ausstehende Update wird heruntergeladen. |
UPDATE_STATE_NEED_REBOOT |
Das Gerät ist bereit, das Update zu installieren, muss aber neu gestartet werden. |
DeprovisionReason
Der Grund für die Aufhebung der Bereitstellung eines ChromeOS-Geräts.
Enums | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Der Grund für die Deaktivierung 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 beschränkten Garantie 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 für das Gerät ist abgelaufen. |
DEPROVISION_REASON_OTHER |
Die Bereitstellung des Geräts wurde aus einem Grund aufgehoben, der 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 eines mit gehobener Ausstattung ersetzen. |
DEPROVISION_REASON_RETIRING_DEVICE |
Aus dem Gerätepool aussortiert. Sie möchten das Gerät spenden, entsorgen oder die Nutzung anderweitig einstellen. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
ChromeOS Flex-Upgrade übertragen Dies ist ein ChromeOS Flex-Gerät, das Sie innerhalb eines Jahres durch ein Chromebook ersetzen möchten. |
DEPROVISION_REASON_NOT_REQUIRED |
Ein Grund war nicht erforderlich. Die Lizenzen wurden beispielsweise an den Lizenzpool des Kunden zurückgegeben. |
DEPROVISION_REASON_REPAIR_CENTER |
Die Bereitstellung des Geräts wurde vom Reparaturservicecenter aufgehoben. Kann nur vom Reparaturservicecenter während der RMA festgelegt werden. |
DeviceLicenseType
Der Lizenztyp dieses Geräts.
Enums | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Der Lizenztyp ist unbekannt. |
ENTERPRISE |
Das Gerät wird mit einem unbefristeten Chrome Enterprise-Upgrade angeboten. |
ENTERPRISE_UPGRADE |
Das Gerät hat 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 mit einem unbefristeten Chrome Education-Upgrade geliefert. |
KIOSK_UPGRADE |
Das Gerät hat ein jährliches Kiosk-Upgrade. |
BacklightInfo
Informationen zur 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 Anrufer andere Informationen abgleichen muss. |
maxBrightness |
Nur Ausgabe. Maximale Helligkeit der Hintergrundbeleuchtung. |
brightness |
Nur Ausgabe. Aktuelle Helligkeit der Hintergrundbeleuchtung zwischen 0 und „maxBrightness“. |
FanInfo
Informationen zum Lüfter des Geräts.
JSON-Darstellung |
---|
{ "speedRpm": integer } |
Felder | |
---|---|
speedRpm |
Nur Ausgabe. Lüftergeschwindigkeit in Umdrehungen pro Minute. |
ChromeOsType
ChromeOS-Typ des Geräts.
Enums | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
ChromeOS-Typ nicht angegeben. |
CHROME_OS_FLEX |
ChromeOS Flex eingeben |
CHROME_OS |
ChromeOS Geben Sie „ChromeOS“ ein. |
ByteUsage
Stellt eine Datenkapazität mit einer bestimmten aktuellen Nutzung in Byte dar.
JSON-Darstellung |
---|
{ "capacityBytes": string, "usedBytes": string } |
Felder | |
---|---|
capacityBytes |
Nur Ausgabe. Die Gesamtkapazität in Byte. |
usedBytes |
Nur Ausgabe. Der aktuelle Nutzungswert in Byte. |
Methoden |
|
---|---|
(deprecated) |
Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. |
|
Ruft die Eigenschaften eines ChromeOS-Geräts ab. |
|
Ruft eine paginated Liste der ChromeOS-Geräte in einem Konto ab. |
|
Verschiebt oder fügt mehrere ChromeOS-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 . |