Ressource: ChromeOsDevice
Auf Google Chrome-Geräten wird ChromeOS ausgeführt. 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 bei der Aktivierung 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 der letzten Synchronisierung des Geräts mit den Richtlinieneinstellungen in der Admin-Konsole. Der Wert ist im Datums- und Zeitformat nach ISO 8601. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
supportEndDate |
Das letzte Datum, an dem das Gerät unterstützt wird. Dies gilt nur für Geräte, die direkt bei Google gekauft wurden. Der Wert ist im Datums- und Zeitformat nach ISO 8601. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
annotatedUser |
Der Nutzer des Geräts, wie vom Administrator angegeben. 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 angegeben. Die maximale Länge beträgt |
notes |
Vom Administrator hinzugefügte Hinweise zu diesem Gerät. Diese Eigenschaft kann mit dem Parameter |
model |
Informationen zum Gerätemodell. 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 normalerweise verwendet, wenn ein Gerät dem Servicetarif eines Mobilfunkanbieters zugeordnet 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 des Supports automatisch verlängert wird. Dies ist eine schreibgeschützte Eigenschaft. |
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, 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 nach ISO 8601. Die Zeit ist das vollständige Datum plus Stunden, Minuten und Sekunden im Format |
kind |
Der Ressourcentyp. Für die Ressource „Chromeosdevices“ ist der Wert |
recentUsers[] |
Eine Liste der letzten Gerätenutzer, sortiert nach dem Zeitpunkt der letzten Anmeldung in absteigender Reihenfolge. |
recentUsers[].type |
Der Nutzertyp. Akzeptable Werte sind:
|
recentUsers[].email |
Die E-Mail-Adresse des Nutzers. Diese Option ist nur verfügbar, wenn der Nutzertyp |
activeTimeRanges[] |
Eine Liste der aktiven Zeiträume (schreibgeschützt). |
activeTimeRanges[].activeTime |
Nutzungsdauer in Millisekunden. |
activeTimeRanges[].date |
Nutzungsdatum. |
ethernetMacAddress |
Die MAC-Adresse des Geräts auf der Ethernet-Netzwerkschnittstelle. |
annotatedAssetId |
Die Asset-ID, wie vom Administrator angegeben oder bei der Registrierung festgelegt. |
etag |
ETag der Ressource. |
diskVolumeReports[] |
Berichte zum Speicherplatz und andere Informationen zu eingebundenen/verbundenen Volumes. |
diskVolumeReports[].volumeInfo[] |
Laufwerk-Volumes |
diskVolumeReports[].volumeInfo[].volumeId |
Volume-ID |
diskVolumeReports[].volumeInfo[].storageTotal |
Gesamtspeicherplatz [in Byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Freier Speicherplatz [in Byte] |
systemRamTotal |
Gesamter Arbeitsspeicher auf dem Gerät in Byte |
cpuStatusReports[] |
Berichte zur CPU-Auslastung und ‑Temperatur (schreibgeschützt) |
cpuStatusReports[].reportTime |
Datum und Uhrzeit des Eingangs des Berichts. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Eine Liste mit CPU-Temperaturmessungen. |
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 für die logischen CPUs |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Die maximale Frequenz, mit der die CPU gemäß Richtlinie betrieben werden darf. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Aktuelle Frequenz, mit der die CPU ausgeführt wird. |
cpuInfo[].logicalCpus[].idleDuration |
Leerlaufzeit 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 Dokumentation des CPU-Herstellers. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Name des Bundesstaates. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Zeit, die seit dem letzten Neustart im Status verbracht wurde. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
deviceFiles[] |
Eine Liste der herunterzuladenden Gerätedateien (schreibgeschützt) |
deviceFiles[].name |
Dateiname |
deviceFiles[].type |
Dateityp |
deviceFiles[].downloadUrl |
Download-URL für Datei |
deviceFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
systemRamFreeReports[] |
Berichte über die Menge des verfügbaren RAM-Speichers (schreibgeschützt) |
systemRamFreeReports[].reportTime |
Datum und Uhrzeit des Eingangs 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 |
(Schreibgeschützt) Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder keinen Support mehr erhält. Verwenden Sie stattdessen „autoUpdateThrough“. |
ethernetMacAddress0 |
(Nur lesen) MAC-Adresse, die vom internen Ethernet-Anschluss des Chromebooks und für die integrierte Netzwerkschnittstelle (Ethernet) verwendet wird. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Das ist nur für einige Geräte relevant. |
dockMacAddress |
(Schreibgeschützt) Integrierte MAC-Adresse der Dockingstation, mit der das Gerät verbunden ist. Legt die werkseitig zugewiesene MAC-Adresse (Media Access Control) fest, die von einem Dock verwendet werden soll. Sie ist speziell für die Geräte-Richtlinie für MAC-Passthrough reserviert. Das Format besteht aus zwölf (12) Hexadezimalziffern ohne Trennzeichen (Großbuchstaben). Das ist nur für einige Geräte relevant. |
manufactureDate |
(Nur-Lesezugriff) Das Herstellungsdatum des Geräts im Format JJJJ-MM-TT. |
orgUnitPath |
Der vollständige übergeordnete Pfad mit dem Namen der Organisationseinheit, die dem Gerät zugeordnet ist. Bei Pfadnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn die übergeordnete Organisationseinheit die oberste Organisation ist, wird sie als 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 herunterzuladenden Screenshot-Dateien. Der Typ ist immer „SCREENSHOT_FILE“. (schreibgeschützt) |
screenshotFiles[].name |
Dateiname |
screenshotFiles[].type |
Dateityp |
screenshotFiles[].downloadUrl |
Download-URL für Datei |
screenshotFiles[].createTime |
Datum und Uhrzeit der Dateierstellung |
orgUnitId |
Die eindeutige ID der Organisationseinheit. orgUnitPath ist die für Menschen lesbare Version von orgUnitId. Der Wert für orgUnitPath kann sich ändern, wenn eine Organisationseinheit im Pfad umbenannt wird. Die orgUnitId ist für eine Organisationseinheit jedoch unveränderlich. Diese Eigenschaft kann über die API aktualisiert werden. Weitere Informationen zum Erstellen einer Organisationsstruktur für Ihr Gerät finden Sie in der Administratorhilfe. |
osUpdateStatus |
Der Status der Betriebssystem-Updates 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. |
autoUpdateThrough |
Nur Ausgabe. Der Zeitstempel, nach dem das Gerät keine Chrome-Updates oder keinen Support mehr erhält. |
extendedSupportEligible |
Nur Ausgabe. Gibt an, ob für das Gerät die Zustimmung zum erweiterten Support erforderlich ist. |
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 erweiterten Support auf dem Gerät aktiviert ist. |
fanInfo[] |
Nur Ausgabe. Informationen zum Lüfter des Geräts. |
chromeOsType |
Nur Ausgabe. Chrome OS-Typ des Geräts. |
diskSpaceUsage |
Nur Ausgabe. Wie viel Speicherplatz auf dem Gerät verfügbar ist und wie viel derzeit verwendet wird. |
osVersionCompliance |
Nur Ausgabe. Compliancestatus der Betriebssystemversion in Bezug auf die Geräterichtlinie. |
OsUpdateStatus
Enthält Informationen zum aktuellen Status des Betriebssystemupdates.
JSON-Darstellung |
---|
{
"state": enum ( |
Felder | |
---|---|
state |
Der Updatestatus eines Betriebssystemupdates. |
targetOsVersion |
Eine neue Plattformversion des Betriebssystem-Images wird heruntergeladen und angewendet. Sie wird nur festgelegt, wenn der Aktualisierungsstatus UPDATE_STATUS_DOWNLOAD_IN_PROGRESS oder UPDATE_STATUS_NEED_REBOOT lautet. Hinweis: In einigen Grenzfall-Szenarien kann dies eine Dummy-IP-Adresse (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 der ausstehenden aktualisierten Kiosk-App. |
updateTime |
Datum und Uhrzeit des letzten erfolgreichen Betriebssystem-Updates. |
updateCheckTime |
Datum und Uhrzeit der letzten Überprüfung auf Updates. |
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 an, wurde aber noch nicht gestartet. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Das ausstehende Update wird heruntergeladen. |
UPDATE_STATE_NEED_REBOOT |
Das Gerät kann das Update 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 Aufhebung 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 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 Legacy-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 |
Es war kein Grund erforderlich. Die Lizenzen wurden beispielsweise in den Lizenzpool des Kunden zurückgegeben. |
DEPROVISION_REASON_REPAIR_CENTER |
Die Bereitstellung des Geräts wurde vom Reparaturcenter aufgehoben. Kann nur vom Reparaturcenter während der Rücksendung mit Autorisierung (RMA) 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 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 gehört zu einem Bundle mit einem unbefristeten Chrome Education-Upgrade. |
KIOSK_UPGRADE |
Das Gerät hat ein Jahres-Upgrade für Kioske. |
ENTERPRISE_UPGRADE_PERPETUAL |
Gibt an, dass für das Gerät ein eigenständiges, unbefristetes Chrome Enterprise-Upgrade oder eine Chrome Enterprise-Lizenz verwendet wird. |
ENTERPRISE_UPGRADE_FIXED_TERM |
Gibt an, dass auf dem Gerät ein eigenständiges Chrome Enterprise-Upgrade mit fester Laufzeit oder eine Chrome Enterprise-Lizenz verwendet wird. |
EDUCATION_UPGRADE_PERPETUAL |
Gibt an, dass auf dem Gerät ein eigenständiges, unbefristetes Chrome Education-Upgrade(auch als unbefristete Chrome EDU-Lizenz bezeichnet) verwendet wird. |
EDUCATION_UPGRADE_FIXED_TERM |
Gibt an, dass für das Gerät ein eigenständiges Chrome Education-Upgrade mit fester Laufzeit(auch als Chrome EDU-Lizenz mit fester Laufzeit bezeichnet) verwendet wird. |
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 die Informationen mit anderen Daten in Beziehung setzen muss. |
maxBrightness |
Nur Ausgabe. Maximale Helligkeit für die 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 U/min. |
ChromeOsType
Chrome OS-Typ des Geräts.
Enums | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
ChromeOS-Typ nicht angegeben. |
CHROME_OS_FLEX |
ChromeOS-Typ: ChromeOS Flex |
CHROME_OS |
Chrome OS: Geben Sie „Chrome OS“ ein. |
ByteUsage
Stellt eine Datenkapazität mit einer bestimmten Menge an aktueller Nutzung in Byte dar.
JSON-Darstellung |
---|
{ "capacityBytes": string, "usedBytes": string } |
Felder | |
---|---|
capacityBytes |
Nur Ausgabe. Der Gesamtkapazitätswert in Byte. |
usedBytes |
Nur Ausgabe. Der aktuelle Nutzungswert in Byte. |
Compliance
Compliancestatus der Betriebssystemversion in Bezug auf die Geräterichtlinie.
Enums | |
---|---|
COMPLIANCE_UNSPECIFIED |
Der Compliance-Status ist nicht angegeben. |
COMPLIANT |
Compliancestatus „Konform“. |
PENDING |
Der Compliancestatus ist „Ausstehend“. |
NOT_COMPLIANT |
Der Compliancestatus ist nicht konform. |
Methoden |
|
---|---|
(deprecated) |
Verwenden Sie stattdessen BatchChangeChromeOsDeviceStatus. |
|
Ruft die Eigenschaften eines Chrome OS-Geräts ab. |
|
Ruft eine paginierte Liste von ChromeOS-Geräten 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 . |