Risorsa: ChromeOsDevice
I dispositivi Google Chrome funzionano con Chrome OS. Per saperne di più sulle attività 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 quando è stato attivato. Questo valore corrisponde al Numero di serie della Console di amministrazione nella scheda Dispositivi ChromeOS. |
status |
Lo stato del dispositivo. I valori accettabili sono:
|
lastSync |
La data e l'ora in cui il dispositivo è stato sincronizzato l'ultima volta con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato data e ora ISO 8601. L'ora è la 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 data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel formato |
annotatedUser |
L'utente del dispositivo in base a quanto annotato dall'amministratore. La lunghezza massima è di 100 caratteri. Sono consentiti valori vuoti. |
annotatedLocation |
L'indirizzo o la posizione del dispositivo in base a quanto annotato dall'amministratore. La lunghezza massima è di |
notes |
Note su questo dispositivo aggiunte dall'amministratore. È possibile cercare questa proprietà con il parametro |
model |
Le informazioni sul modello del dispositivo. Se il dispositivo non dispone di queste informazioni, questa proprietà non viene inclusa nella risposta. |
meid |
L'identificatore MEID (Mobile Equipment Identifier) o l'identificativo IMEI (International Mobile Equipment Identity) della scheda mobile 3G in un dispositivo mobile. Un MEID/IMEI viene in genere utilizzato quando si aggiunge un dispositivo al piano di servizio post-pagamento di un operatore di telefonia mobile. Se il dispositivo non dispone di queste informazioni, questa proprietà non viene inclusa nella risposta. Per saperne di più su come esportare un elenco di 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 |
Determina se il supporto del dispositivo verrà rinnovato automaticamente 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 |
Data e ora dell'ultima registrazione del dispositivo. Il valore è nel formato data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel formato |
kind |
Il tipo di risorsa. Per la risorsa Chromeosdevices, il valore è |
recentUsers[] |
Un elenco degli utenti recenti del dispositivo, in ordine decrescente, in base all'ora dell'ultimo accesso. |
recentUsers[].type |
Il tipo di utente. I valori accettabili 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 dell'utilizzo in millisecondi. |
activeTimeRanges[].date |
Data di utilizzo. |
ethernetMacAddress |
L'indirizzo MAC del dispositivo sull'interfaccia di rete Ethernet. |
annotatedAssetId |
L'identificatore della risorsa in base a quanto annotato da un amministratore o specificato in sede di registrazione. |
etag |
ETag della risorsa. |
diskVolumeReports[] |
Report sullo spazio su disco e altre informazioni sui volumi montati/connessi. |
diskVolumeReports[].volumeInfo[] |
Volumi disco |
diskVolumeReports[].volumeInfo[].volumeId |
ID volume |
diskVolumeReports[].volumeInfo[].storageTotal |
Spazio su disco totale [in byte] |
diskVolumeReports[].volumeInfo[].storageFree |
Spazio libero su disco [in byte] |
systemRamTotal |
RAM totale sul dispositivo in byte |
cpuStatusReports[] |
Report sull'utilizzo e sulla temperatura della CPU (sola lettura) |
cpuStatusReports[].reportTime |
La data e l'ora in cui è stata ricevuta la segnalazione. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Un elenco di campioni di temperatura della CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura in gradi Celsius. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Etichetta CPU |
cpuInfo[] |
Informazioni sulle specifiche della CPU nel dispositivo. |
cpuInfo[].model |
Il nome del modello della CPU. |
cpuInfo[].architecture |
L'architettura della CPU. |
cpuInfo[].maxClockSpeedKhz |
La velocità di clock massima della CPU in kHz. |
cpuInfo[].logicalCpus[] |
Informazioni sulle CPU logiche |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frequenza massima a cui la CPU può funzionare, in base alle norme. |
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 saperne di più, 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 sugli importi della memoria RAM disponibile (sola lettura) |
systemRamFreeReports[].reportTime |
La data e l'ora in cui è stata ricevuta la segnalazione. |
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 per Chrome. Al suo posto, usa "autoUpdateThrough". |
ethernetMacAddress0 |
(Sola lettura) Indirizzo MAC utilizzato dalla porta Ethernet interna di Chromebook e per l'interfaccia di rete (Ethernet) integrata. Il formato è di dodici (12) cifre esadecimali senza delimitatore (lettere maiuscole). Questo vale solo per alcuni dispositivi. |
dockMacAddress |
(Sola lettura) Indirizzo MAC integrato per la docking station a cui è connesso il dispositivo. Imposta l'indirizzo Media Access Control (indirizzo MAC) assegnato per l'utilizzo da parte di un dock. È riservato specificamente ai criteri per i dispositivi di pass-through MAC. Il formato è di dodici (12) cifre esadecimali senza delimitatore (lettere maiuscole). Questo vale 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 |
Famiglia TPM. Utilizziamo la codifica in stile TPM 2.0, ad esempio: |
tpmVersionInfo.specLevel |
Livello di specifica del TPM. Consulta la specifica della libreria per TPM 2.0 e la specifica principale per TPM 1.2. |
tpmVersionInfo.manufacturer |
Codice produttore TPM. |
tpmVersionInfo.tpmModel |
Numero di modello del TPM. |
tpmVersionInfo.firmwareVersion |
Versione firmware TPM. |
tpmVersionInfo.vendorSpecific |
Informazioni specifiche del fornitore, come 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 dell'orgUnitId. Anche se orgUnitPath può cambiare rinominando un'unità organizzativa all'interno del percorso, orgUnitId è immutabile 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, consulta 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 della rimozione. |
deviceLicenseType |
Solo output. Tipo di licenza del dispositivo. |
backlightInfo[] |
Solo output. Contiene informazioni sulla retroilluminazione del dispositivo. |
autoUpdateThrough |
Solo output. Il timestamp dopo il quale il dispositivo non riceverà più aggiornamenti o assistenza per Chrome. |
extendedSupportEligible |
Solo output. Se il dispositivo richiede o meno l'attivazione del supporto esteso. |
extendedSupportStart |
Solo output. Data in cui inizia la norma di assistenza estesa per gli aggiornamenti automatici del dispositivo. |
extendedSupportEnabled |
Solo output. Indica se il criterio di supporto esteso è attivato sul dispositivo. |
fanInfo[] |
Solo output. Informazioni sulla ventola del dispositivo. |
chromeOsType |
Solo output. Tipo di Chrome OS del dispositivo. |
diskSpaceUsage |
Solo output. Quantità di spazio su disco disponibile e attualmente utilizzata dal dispositivo. |
osVersionCompliance |
Solo output. Stato di conformità ai criteri del dispositivo della versione del sistema operativo. |
OsUpdateStatus
Contiene informazioni sullo stato attuale dell'aggiornamento del sistema operativo.
Rappresentazione JSON |
---|
{
"state": enum ( |
Campi | |
---|---|
state |
Lo stato di aggiornamento di un aggiornamento del sistema operativo. |
targetOsVersion |
Nuova versione della piattaforma dell'immagine sistema operativo in fase di download e applicazione. Viene impostato solo quando lo stato dell'aggiornamento è UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Tieni presente che in alcuni casi limite, ad esempio quando il motore di aggiornamento viene riavviato senza riavvio, questo potrebbe essere un valore fittizio "0.0.0.0" per UPDATE_STATUS_NEED_REBOOT. |
targetKioskAppVersion |
Nuova versione della piattaforma richiesta dall'app per chiosco 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 aggiornamento di un aggiornamento del sistema operativo.
Enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
Lo stato dell'aggiornamento non è specificato. |
UPDATE_STATE_NOT_STARTED |
È in attesa un aggiornamento, ma non è ancora iniziato. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
È in corso il download dell'aggiornamento in attesa. |
UPDATE_STATE_NEED_REBOOT |
Il dispositivo è pronto per installare l'aggiornamento, ma deve essere riavviato. |
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. Disponi di una RMA (autorizzazione al reso) oppure stai sostituendo un dispositivo malfunzionante in garanzia 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 |
Il servizio è scaduto per il dispositivo. |
DEPROVISION_REASON_OTHER |
Il dispositivo è stato sottoposto a deprovisioning per un motivo precedente che non è più supportato. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Sostituzione modello diverso. Stai sostituendo questo dispositivo con un modello aggiornato o più recente. |
DEPROVISION_REASON_RETIRING_DEVICE |
Ritiro dal parco dispositivi. Stai donando, smaltendo o rimuovendo in altro modo il dispositivo. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Trasferimento upgrade ChromeOS Flex. È un dispositivo ChromeOS Flex che vuoi sostituire con Chromebook entro un anno. |
DEPROVISION_REASON_NOT_REQUIRED |
Non era necessario specificare un motivo. Ad esempio, le licenze sono state restituite al pool di licenze del cliente. |
DEPROVISION_REASON_REPAIR_CENTER |
Il dispositivo è stato sottoposto a deprovisioning dal Centro riparazioni. Può essere impostato solo dal centro riparazioni durante l'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 un upgrade perpetuo di Chrome Enterprise. |
ENTERPRISE_UPGRADE |
Il dispositivo dispone di un upgrade annuale di Chrome Enterprise Upgrade autonomo. |
EDUCATION_UPGRADE |
Il dispositivo dispone di un upgrade perpetuo autonomo di Chrome Education Upgrade. |
EDUCATION |
Il dispositivo è in bundle con Chrome Education Upgrade perpetuo. |
KIOSK_UPGRADE |
Il dispositivo ha un upgrade annuale di Kiosk. |
ENTERPRISE_UPGRADE_PERPETUAL |
Indica che il dispositivo utilizza una licenza Chrome Enterprise Upgrade perpetua e autonoma, una licenza Chrome Enterprise. |
ENTERPRISE_UPGRADE_FIXED_TERM |
Indica che il dispositivo utilizza una licenza Chrome Enterprise Upgrade autonoma a termine fisso o una licenza Chrome Enterprise. |
EDUCATION_UPGRADE_PERPETUAL |
Indica che il dispositivo utilizza un upgrade perpetuo autonomo di Chrome Education Upgrade(ovvero una licenza perpetua di Chrome EDU). |
EDUCATION_UPGRADE_FIXED_TERM |
Indica che il dispositivo utilizza una licenza Chrome Education Upgrade autonoma a durata fissa(nota anche come licenza Chrome EDU a durata fissa). |
BacklightInfo
Informazioni sulle retroilluminazioni del dispositivo.
Rappresentazione JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Campi | |
---|---|
path |
Solo output. Percorso di questa retroilluminazione sul sistema. Utile se il chiamante deve correlare le informazioni con altre. |
maxBrightness |
Solo output. Luminosità massima della retroilluminazione. |
brightness |
Solo output. La luminosità attuale della retroilluminazione, compresa tra 0 e maxBrightness. |
FanInfo
Informazioni sulla ventola del dispositivo.
Rappresentazione JSON |
---|
{ "speedRpm": integer } |
Campi | |
---|---|
speedRpm |
Solo output. Velocità della ventola in RPM. |
ChromeOsType
Tipo di Chrome OS del dispositivo.
Enum | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Tipo di ChromeOS non specificato. |
CHROME_OS_FLEX |
Tipo di ChromeOS ChromeOS Flex. |
CHROME_OS |
Tipo di ChromeOS. |
ByteUsage
Rappresenta una capacità di dati con una certa quantità di utilizzo attuale in byte.
Rappresentazione JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
Campi | |
---|---|
capacityBytes |
Solo output. Il valore della capacità totale, in byte. |
usedBytes |
Solo output. Il valore di utilizzo attuale, in byte. |
Conformità
Stato di conformità ai criteri del dispositivo della versione del sistema operativo.
Enum | |
---|---|
COMPLIANCE_UNSPECIFIED |
Stato di conformità non specificato. |
COMPLIANT |
Stato di conformità conforme. |
PENDING |
Stato di conformità in attesa. |
NOT_COMPLIANT |
Stato di conformità non conforme. |
Metodi |
|
---|---|
(deprecated) |
Utilizza BatchChangeChromeOsDeviceStatus. |
|
Recupera le proprietà di un dispositivo ChromeOS. |
|
Recupera un elenco paginato 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, ad esempio annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |
|
Aggiorna le proprietà aggiornabili di un dispositivo, ad esempio annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |