Risorsa: ChromeOsDevice
I dispositivi Google Chrome eseguono il sistema operativo Chrome OS. Per ulteriori informazioni sulle attività più comuni dell'API, consulta la Guida per gli sviluppatori.
Rappresentazione 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 ( |
Campi | |
---|---|
deviceId |
L'ID univoco del dispositivo Chrome. |
serialNumber |
Il numero di serie del dispositivo Chrome inserito al momento dell'attivazione del dispositivo. Questo valore corrisponde al numero di serie della Console di amministrazione nella scheda Dispositivi ChromeOS. |
status |
Lo stato del dispositivo. I valori accettati sono:
|
lastSync |
La data e l'ora in cui il dispositivo è stato sincronizzato per l'ultima volta con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato di data e ora ISO 8601. L'ora corrisponde alla data completa più ore, minuti e secondi nel formato |
supportEndDate |
La data finale in cui il dispositivo sarà supportato. Questo vale solo per i dispositivi acquistati direttamente da Google. Il valore è nel formato di data e ora ISO 8601. L'ora corrisponde alla data completa più ore, minuti e secondi nel formato |
annotatedUser |
L'utente del dispositivo, come indicato dall'amministratore. La lunghezza massima è di 100 caratteri. Sono consentiti valori vuoti. |
annotatedLocation |
L'indirizzo o la posizione del dispositivo in base a quanto indicato dall'amministratore. La lunghezza massima è di |
notes |
Note su questo dispositivo aggiunte dall'amministratore. Questa proprietà può essere ricercata con il parametro |
model |
Informazioni sul modello del dispositivo. Se il dispositivo non dispone di queste informazioni, la proprietà non è inclusa nella risposta. |
meid |
Il Mobile Equipment Identifier (MEID) o l'IMEI (International Mobile Equipment Identity) per la carta mobile 3G su un dispositivo mobile. Il codice MEID/IMEI viene generalmente utilizzato per aggiungere un dispositivo al piano di servizio con pagamento posticipato di un operatore wireless. Se il dispositivo non dispone di queste informazioni, la proprietà non è inclusa nella risposta. Per saperne di più su come esportare un elenco MEID/IMEI, consulta la Guida per gli sviluppatori. |
orderNumber |
Il numero d'ordine del dispositivo. Solo i dispositivi acquistati direttamente da Google hanno un numero d'ordine. |
willAutoRenew |
Consente di stabilire se il dispositivo rinnoverà automaticamente il supporto dopo la data di fine del supporto. Questa è una proprietà di sola lettura. |
osVersion |
La versione del sistema operativo del dispositivo Chrome. |
platformVersion |
La versione della piattaforma del dispositivo Chrome. |
firmwareVersion |
La versione del firmware del dispositivo Chrome. |
macAddress |
L'indirizzo MAC wireless del dispositivo. Se il dispositivo non dispone di queste informazioni, non vengono incluse nella risposta. |
bootMode |
La modalità di avvio del dispositivo. I valori possibili sono:
|
lastEnrollmentTime |
La data e l'ora dell'ultima registrazione del dispositivo. Il valore è nel formato di data e ora ISO 8601. L'ora corrisponde alla data completa più ore, minuti e secondi nel formato |
kind |
Il tipo di risorsa. Per la risorsa Chromeosdevices, il valore è |
recentUsers[] |
Un elenco di utenti recenti del dispositivo, in ordine decrescente, in base all'ora dell'ultimo accesso. |
recentUsers[].type |
Il tipo di utente. I valori accettati sono:
|
recentUsers[].email |
L'indirizzo email dell'utente. È presente solo se il tipo di utente è |
activeTimeRanges[] |
Un elenco di intervalli di tempo attivi (sola lettura). |
activeTimeRanges[].activeTime |
Durata di utilizzo in millisecondi. |
activeTimeRanges[].date |
Data di utilizzo. |
ethernetMacAddress |
L'indirizzo MAC del dispositivo sull'interfaccia di rete Ethernet. |
annotatedAssetId |
L'identificatore della risorsa indicato da un amministratore o specificato durante la registrazione. |
etag |
ETag della risorsa. |
diskVolumeReports[] |
Report sullo spazio su disco e altre informazioni sui volumi montati/connessi. |
diskVolumeReports[].volumeInfo[] |
Volumi del disco |
diskVolumeReports[].volumeInfo[].volumeId |
ID volume |
diskVolumeReports[].volumeInfo[].storageTotal |
Spazio totale su disco [in byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Spazio libero su disco [in byte] |
systemRamTotal |
RAM totale del dispositivo in byte |
cpuStatusReports[] |
Report sull'utilizzo e sulla temperatura della CPU (sola lettura) |
cpuStatusReports[].reportTime |
La data e l'ora in cui il report è stato ricevuto. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Un elenco di esempi di temperatura della CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura in gradi Celsius. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Etichetta CPU |
cpuInfo[] |
Informazioni relative alle specifiche della CPU nel dispositivo. |
cpuInfo[].model |
Il nome del modello di CPU. |
cpuInfo[].architecture |
L'architettura della CPU. |
cpuInfo[].maxClockSpeedKhz |
La velocità di clock massima della CPU in kHz. |
cpuInfo[].logicalCpus[] |
Informazioni per le CPU logiche |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frequenza massima di esecuzione della CPU, per criterio. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Frequenza attuale di esecuzione della CPU. |
cpuInfo[].logicalCpus[].idleDuration |
Tempo di inattività dall'ultimo avvio. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
cpuInfo[].logicalCpus[].cStates[] |
Gli stati C indicano lo stato di consumo energetico della CPU. Per ulteriori informazioni, consulta la documentazione pubblicata dal produttore della CPU. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Nome dello stato. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Tempo trascorso nello stato dall'ultimo riavvio. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
deviceFiles[] |
Un elenco di file del dispositivo da scaricare (sola lettura) |
deviceFiles[].name |
Nome file |
deviceFiles[].type |
Tipo di file |
deviceFiles[].downloadUrl |
URL di download del file |
deviceFiles[].createTime |
Data e ora di creazione del file |
systemRamFreeReports[] |
Report sulla quantità di memoria RAM disponibile (sola lettura) |
systemRamFreeReports[].reportTime |
La data e l'ora in cui il report è stato ricevuto. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Contiene l'ultima rete nota (sola lettura) |
lastKnownNetwork[].ipAddress |
L'indirizzo IP. |
lastKnownNetwork[].wanIpAddress |
L'indirizzo IP WAN. |
autoUpdateExpiration |
(Sola lettura) Il timestamp dopo il quale il dispositivo smetterà di ricevere aggiornamenti o assistenza di Chrome |
ethernetMacAddress0 |
(Sola lettura) Indirizzo MAC utilizzato dalla porta Ethernet interna del Chromebook e per l'interfaccia di rete integrata (ethernet). Il formato è di dodici (12) cifre esadecimali senza delimitatori (lettere maiuscole). È pertinente solo per alcuni dispositivi. |
dockMacAddress |
(Sola lettura) Indirizzo MAC integrato per la docking station a cui è collegato il dispositivo. Il produttore imposta l'indirizzo MAC (Media Access Control) assegnato per l'utilizzo da un dock. È riservato specificamente ai criteri relativi ai dispositivi pass-through MAC. Il formato è di dodici (12) cifre esadecimali senza delimitatori (lettere maiuscole). È pertinente solo per alcuni dispositivi. |
manufactureDate |
(Sola lettura) La data di produzione del dispositivo nel formato aaaa-mm-gg. |
orgUnitPath |
Il percorso principale completo con il nome dell'unità organizzativa associata al dispositivo. I nomi dei percorsi non fanno distinzione tra maiuscole e minuscole. Se l'unità organizzativa principale è l'organizzazione di primo livello, è rappresentata da una barra, |
tpmVersionInfo |
Trusted Platform Module (TPM) (sola lettura) |
tpmVersionInfo.family |
la famiglia TPM. Utilizziamo la codifica di stile TPM 2.0, ad esempio: |
tpmVersionInfo.specLevel |
Livello di specifica TPM. Vedi le specifiche della libreria per TPM 2.0 e le specifiche principali per TPM 1.2. |
tpmVersionInfo.manufacturer |
Codice produttore TPM. |
tpmVersionInfo.tpmModel |
Numero di modello TPM. |
tpmVersionInfo.firmwareVersion |
Versione firmware TPM. |
tpmVersionInfo.vendorSpecific |
Informazioni specifiche sul fornitore, ad esempio l'ID fornitore. |
screenshotFiles[] |
Un elenco di file di screenshot da scaricare. Il tipo è sempre "SCREENSHOT_FILE". (Sola lettura) |
screenshotFiles[].name |
Nome file |
screenshotFiles[].type |
Tipo di file |
screenshotFiles[].downloadUrl |
URL di download del file |
screenshotFiles[].createTime |
Data e ora di creazione del file |
orgUnitId |
L'ID univoco dell'unità organizzativa. orgUnitPath è la versione leggibile di orgUnitId. Mentre orgUnitPath può cambiare rinominando un'unità organizzativa all'interno del percorso, orgUnitId non può essere modificato per un'unità organizzativa. Questa proprietà può essere aggiornata utilizzando l'API. Per ulteriori informazioni su come creare una struttura organizzativa per il tuo dispositivo, visita il Centro assistenza per l'amministrazione. |
osUpdateStatus |
Lo stato degli aggiornamenti del sistema operativo per il dispositivo. |
firstEnrollmentTime |
Data e ora della prima registrazione del dispositivo. |
lastDeprovisionTimestamp |
(Sola lettura) Data e ora dell'ultimo deprovisioning del dispositivo. |
deprovisionReason |
(Sola lettura) Motivo del deprovisioning. |
deviceLicenseType |
Solo output. Tipo di licenza del dispositivo. |
backlightInfo[] |
Solo output. Contiene informazioni sulla retroilluminazione del dispositivo. |
OsUpdateStatus
Contiene informazioni relative allo stato attuale di aggiornamento del sistema operativo.
Rappresentazione JSON |
---|
{
"state": enum ( |
Campi | |
---|---|
state |
Lo stato di un aggiornamento del sistema operativo. |
targetOsVersion |
Nuova versione della piattaforma dell'immagine del sistema operativo da scaricare e applicare. Viene impostato solo se lo stato dell'aggiornamento è UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Tieni presente che questo potrebbe essere un "0.0.0.0" fittizio per UPDATE_STATUS_NEED_REBOOT per alcuni casi limite, ad esempio il motore di aggiornamento viene riavviato senza riavvio. |
targetKioskAppVersion |
Nuova versione della piattaforma obbligatoria dall'app kiosk aggiornata in attesa. |
updateTime |
Data e ora dell'ultimo aggiornamento del sistema operativo riuscito. |
updateCheckTime |
Data e ora dell'ultimo controllo degli aggiornamenti. |
rebootTime |
Data e ora dell'ultimo riavvio. |
UpdateState
Lo stato di un aggiornamento del sistema operativo.
Enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Lo stato dell'aggiornamento non è specificato. |
UPDATE_STATE_NOT_STARTED |
C'è un aggiornamento in attesa, che però non è iniziato. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
L'aggiornamento in sospeso è in fase di download. |
UPDATE_STATE_NEED_REBOOT |
Il dispositivo è pronto per installare l'aggiornamento, ma deve riavviarsi. |
DeprovisionReason
Il motivo del deprovisioning di un dispositivo ChromeOS.
Enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Il motivo del deprovisioning è sconosciuto. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Sostituzione stesso modello. Hai l'autorizzazione alla restituzione dei materiali (RMA) o stai sostituendo in garanzia un dispositivo che non funziona correttamente con lo stesso modello. |
DEPROVISION_REASON_UPGRADE |
È stato eseguito l'upgrade del dispositivo. |
DEPROVISION_REASON_DOMAIN_MOVE |
Il dominio del dispositivo è stato modificato. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Servizio scaduto per il dispositivo. |
DEPROVISION_REASON_OTHER |
È stato eseguito il deprovisioning del dispositivo per un motivo precedente che non è più supportato. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Sostituzione di un modello diverso. Stai sostituendo questo dispositivo con un modello aggiornato o più recente. |
DEPROVISION_REASON_RETIRING_DEVICE |
Ritiro dal parco risorse. Stai donando, scartare o rimuovere in altro modo il dispositivo dall'uso. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Trasferimento upgrade di ChromeOS Flex. È un dispositivo ChromeOS Flex che vuoi sostituire con Chromebook entro un anno. |
DEPROVISION_REASON_NOT_REQUIRED |
Non era richiesto un motivo. Ad esempio, le licenze sono state restituite al pool di licenze del cliente. |
DEPROVISION_REASON_REPAIR_CENTER |
È stato eseguito il deprovisioning del dispositivo dal Centro servizi riparazioni. Può essere impostato solo dal Centro assistenza riparazioni durante la RMA. |
DeviceLicenseType
Il tipo di licenza di questo dispositivo.
Enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Il tipo di licenza è sconosciuto. |
ENTERPRISE |
Il dispositivo è in bundle con una licenza Chrome Enterprise Upgrade perpetua. |
ENTERPRISE_UPGRADE |
Il dispositivo dispone di una licenza Chrome Enterprise Upgrade annuale autonoma. |
EDUCATION_UPGRADE |
Il dispositivo dispone di una licenza Chrome Education Upgrade perpetua in modalità autonoma. |
EDUCATION |
Il dispositivo è in bundle con una licenza Chrome Education Upgrade perpetua. |
KIOSK_UPGRADE |
Il dispositivo dispone di un upgrade annuale a Kiosk. |
BacklightInfo
Informazioni sulle retroilluminazioni del dispositivo.
Rappresentazione JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Campi | |
---|---|
path |
Solo output. Percorso di questa retroilluminazione del sistema. Utile se il chiamante ha bisogno di essere correlato ad altre informazioni. |
maxBrightness |
Solo output. Luminosità massima per la retroilluminazione. |
brightness |
Solo output. Luminosità attuale della retroilluminazione, compresa tra 0 e maxLuminosità. |
Metodi |
|
---|---|
(deprecated) |
Utilizza BatchChangeChromeOsDeviceStatus. |
|
Recupera le proprietà di un dispositivo ChromeOS. |
|
Recupera un elenco impaginato di dispositivi ChromeOS all'interno di un account. |
|
Sposta o inserisce più dispositivi ChromeOS in un'unità organizzativa. |
|
Aggiorna le proprietà aggiornabili di un dispositivo, come annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |
|
Aggiorna le proprietà aggiornabili di un dispositivo, come annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |