REST Resource: chromeosdevices

Risorsa: ChromeOsDevice

I dispositivi Google Chrome funzionano su ChromeOS. Per ulteriori informazioni 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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType),
  "diskSpaceUsage": {
    object (ByteUsage)
  }
}
Campi
deviceId

string

L'ID univoco del dispositivo Chrome.
serialNumber

string

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

string

Lo stato del dispositivo.

I valori accettabili sono:

  • ACTIVE: il dispositivo è registrato nel dominio.
  • DELINQUENT: la licenza annuale per il dominio è scaduta e il dispositivo non riceve più criteri e impostazioni. Quando viene acquistata una nuova licenza, il dispositivo torna allo stato ACTIVE.
  • PRE_PROVISIONED: il dispositivo è stato registrato per la registrazione zero-touch. Un dispositivo PRE_PROVISIONED può essere spostato in un'altra unità organizzativa o eliminato. Al termine della registrazione, lo stato del dispositivo sarà ACTIVE.
  • DEPROVISIONED: il dispositivo non è più idoneo per la registrazione al dominio. L'ordine è stato annullato. Le impostazioni del dispositivo sono state memorizzate nella cache sul dispositivo. Se il dispositivo viene attivato di nuovo, le impostazioni di sistema più recenti vengono applicate al dispositivo appena attivato.
  • DISABLED: il dispositivo è stato disattivato dall'amministratore e non può essere utilizzato.
  • INACTIVE: il dispositivo non è registrato nel dominio.
  • RETURN_ARRIVED: è arrivata la richiesta di sostituzione di questo dispositivo.
  • RETURN_REQUESTED: è stata effettuata una richiesta di sostituzione di questo dispositivo.
  • SHIPPED: il dispositivo viene spedito dall'inventario di Google. (Deprecato)
  • UNKNOWN: non è possibile determinare lo stato del dispositivo.
lastSync

string

La data e l'ora dell'ultima sincronizzazione del dispositivo 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 YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00.
supportEndDate

string

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 YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00.
annotatedUser

string

L'utente del dispositivo come indicato dall'amministratore. La lunghezza massima è di 100 caratteri. Sono consentiti valori vuoti.
annotatedLocation

string

L'indirizzo o la posizione del dispositivo in base a quanto annotato dall'amministratore. La lunghezza massima è di 200 caratteri. Sono consentiti valori vuoti.
notes

string

Note su questo dispositivo aggiunte dall'amministratore. Questa proprietà può essere cercata con il parametro query del metodo list. La lunghezza massima è di 500 caratteri. Sono consentiti valori vuoti.
model

string

Le informazioni sul modello del dispositivo. Se il dispositivo non dispone di queste informazioni, questa proprietà non è inclusa nella risposta.
meid

string

Il Mobile Equipment Identifier (MEID) o l'International Mobile Equipment Identity (IMEI) 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 wireless. Se il dispositivo non dispone di queste informazioni, questa proprietà non è inclusa nella risposta. Per saperne di più su come esportare un elenco di MEID/IMEI, consulta la Guida per gli sviluppatori.
orderNumber

string

Il numero d'ordine del dispositivo. Solo i dispositivi acquistati direttamente da Google hanno un numero d'ordine.
willAutoRenew

boolean

Determina se il dispositivo rinnoverà automaticamente l'assistenza dopo la data di fine dell'assistenza. Questa è una proprietà di sola lettura.
osVersion

string

La versione del sistema operativo del dispositivo Chrome.
platformVersion

string

La versione della piattaforma del dispositivo Chrome.
firmwareVersion

string

La versione del firmware del dispositivo Chrome.
macAddress

string

L'indirizzo MAC wireless del dispositivo. Se il dispositivo non dispone di queste informazioni, non vengono incluse nella risposta.
bootMode

string

La modalità di avvio del dispositivo. I valori possibili sono:

  • Verified: sul dispositivo è in esecuzione una versione valida di ChromeOS.
  • Dev: l'opzione hardware sviluppatore del dispositivo è attiva. All'avvio, il dispositivo ha una shell della riga di comando. Per un esempio di passaggio allo stato sviluppatore, consulta le informazioni per gli sviluppatori di Chromebook.
lastEnrollmentTime

string

La data e l'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 YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00. Per ulteriori informazioni sulla registrazione automatica e manuale, visita il Centro assistenza Chrome.
kind

string

Il tipo di risorsa. Per la risorsa Chromeosdevices, il valore è admin#directory#chromeosdevice.
recentUsers[]

object

Un elenco di utenti recenti del dispositivo, in ordine decrescente, in base all'ora dell'ultimo accesso.
recentUsers[].type

string

Il tipo di utente.

I valori accettabili sono:

  • USER_TYPE_MANAGED: l'utente è gestito dal dominio.
  • USER_TYPE_UNMANAGED: l'utente non è gestito dal dominio.
recentUsers[].email

string

L'indirizzo email dell'utente. È presente solo se il tipo di utente è USER_TYPE_MANAGED.
activeTimeRanges[]

object

Un elenco di intervalli di tempo attivi (sola lettura).
activeTimeRanges[].activeTime

integer

Durata dell'utilizzo in millisecondi.
activeTimeRanges[].date

string

Data di utilizzo.
ethernetMacAddress

string

L'indirizzo MAC del dispositivo sull'interfaccia di rete Ethernet.
annotatedAssetId

string

L'identificatore della risorsa annotato da un amministratore o specificato durante la registrazione.
etag

string

ETag della risorsa.
diskVolumeReports[]

object

Report sullo spazio su disco e altre informazioni sui volumi montati/connessi.
diskVolumeReports[].volumeInfo[]

object

Volumi dei dischi
diskVolumeReports[].volumeInfo[].volumeId

string

ID volume
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Spazio su disco totale [in byte]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Spazio libero su disco [in byte]
systemRamTotal

string (int64 format)

RAM totale sul dispositivo in byte
cpuStatusReports[]

object

Report sull'utilizzo e sulla temperatura della CPU (sola lettura)
cpuStatusReports[].reportTime

string

Data e ora di ricezione della segnalazione.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Un elenco di campioni di temperatura della CPU.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatura in gradi Celsius.
cpuStatusReports[].cpuTemperatureInfo[].label

string

Etichetta della CPU
cpuInfo[]

object

Informazioni sulle specifiche della CPU del dispositivo.
cpuInfo[].model

string

Il nome del modello della CPU.
cpuInfo[].architecture

string

L'architettura della CPU.
cpuInfo[].maxClockSpeedKhz

integer

La velocità di clock massima della CPU in kHz.
cpuInfo[].logicalCpus[]

object

Informazioni per le CPU logiche
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

La frequenza massima alla quale la CPU può funzionare, in base alle norme.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frequenza attuale alla quale la CPU è in esecuzione.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tempo di inattività dall'ultimo avvio.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

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

string

Nome dello stato.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Tempo trascorso nello stato dall'ultimo riavvio.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
deviceFiles[]

object

Un elenco di file del dispositivo da scaricare (sola lettura)
deviceFiles[].name

string

Nome file
deviceFiles[].type

string

Tipo di file
deviceFiles[].downloadUrl

string

URL di download del file
deviceFiles[].createTime

string

Data e ora di creazione del file
systemRamFreeReports[]

object

Report sulle quantità di memoria RAM disponibile (sola lettura)
systemRamFreeReports[].reportTime

string

Data e ora di ricezione della segnalazione.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Contiene l'ultima rete nota (sola lettura)
lastKnownNetwork[].ipAddress

string

L'indirizzo IP.
lastKnownNetwork[].wanIpAddress

string

L'indirizzo IP WAN.
autoUpdateExpiration
(deprecated)

string (int64 format)

(Sola lettura) Il timestamp dopo il quale il dispositivo smetterà di ricevere aggiornamenti o assistenza di Chrome. Utilizza invece "autoUpdateThrough".
ethernetMacAddress0

string

(Sola lettura) Indirizzo MAC utilizzato dalla porta ethernet interna di Chromebook e per l'interfaccia di rete (ethernet) integrata. Il formato è costituito da dodici (12) cifre esadecimali senza delimitatori (lettere maiuscole). Questo vale solo per alcuni dispositivi.
dockMacAddress

string

(Sola lettura) Indirizzo MAC integrato della docking station a cui è connesso il dispositivo. L'indirizzo Media Access Control (indirizzo MAC) impostato in fabbrica viene assegnato per l'utilizzo da parte di una base. È riservato specificamente per i criteri del dispositivo di passaggio MAC. Il formato è costituito da dodici (12) cifre esadecimali senza delimitatori (lettere maiuscole). Questo vale solo per alcuni dispositivi.
manufactureDate

string

(Sola lettura) La data di produzione del dispositivo nel formato aaaa-mm-gg.
orgUnitPath

string

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, /. 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 amministrazione.
tpmVersionInfo

object

Trusted Platform Module (TPM) (sola lettura)
tpmVersionInfo.family

string

Famiglia TPM. Utilizziamo la codifica in stile TPM 2.0, ad esempio:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

Livello di specifica TPM. Consulta la specifica della libreria per TPM 2.0 e la specifica principale per TPM 1.2.
tpmVersionInfo.manufacturer

string

Codice del produttore del TPM.
tpmVersionInfo.tpmModel

string

Numero di modello del TPM.
tpmVersionInfo.firmwareVersion

string

Versione del firmware TPM.
tpmVersionInfo.vendorSpecific

string

Informazioni specifiche del fornitore, come l'ID fornitore.
screenshotFiles[]

object

Un elenco di file di screenshot da scaricare. Il tipo è sempre "SCREENSHOT_FILE". (Sola lettura)
screenshotFiles[].name

string

Nome file
screenshotFiles[].type

string

Tipo di file
screenshotFiles[].downloadUrl

string

URL di download del file
screenshotFiles[].createTime

string

Data e ora di creazione del file
orgUnitId

string

L'ID univoco dell'unità organizzativa. orgUnitPath è la versione leggibile da un utente di orgUnitId. Sebbene orgUnitPath possa cambiare rinominando un'unità organizzativa all'interno del percorso, orgUnitId non è modificabile 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 amministrazione.
osUpdateStatus

object (OsUpdateStatus)

Lo stato degli aggiornamenti del sistema operativo per il dispositivo.
firstEnrollmentTime

string

Data e ora della prima registrazione del dispositivo.
lastDeprovisionTimestamp

string

(Sola lettura) Data e ora dell'ultimo deprovisioning del dispositivo.
deprovisionReason

enum (DeprovisionReason)

(Di sola lettura) Motivo della rimozione.
deviceLicenseType

enum (DeviceLicenseType)

Solo output. Tipo di licenza del dispositivo.
backlightInfo[]

object (BacklightInfo)

Solo output. Contiene informazioni sulla retroilluminazione del dispositivo.
autoUpdateThrough

string

Solo output. Il timestamp dopo il quale il dispositivo smetterà di ricevere aggiornamenti o assistenza di Chrome.
extendedSupportEligible

boolean

Solo output. Indica se il dispositivo richiede l'attivazione del supporto esteso.
extendedSupportStart

string

Solo output. Data di inizio del criterio di assistenza estesa per gli aggiornamenti automatici del dispositivo.
extendedSupportEnabled

boolean

Solo output. Indica se il criterio di supporto esteso è attivo sul dispositivo.
fanInfo[]

object (FanInfo)

Solo output. Informazioni sulla ventola del dispositivo.
chromeOsType

enum (ChromeOsType)

Solo output. Il tipo di ChromeOS del dispositivo.
diskSpaceUsage

object (ByteUsage)

Solo output. Quantità di spazio su disco disponibile e attualmente in uso sul dispositivo.

OsUpdateStatus

Contiene informazioni sullo stato attuale dell'aggiornamento del sistema operativo.

Rappresentazione JSON 
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Campi
state

enum (UpdateState)

Lo stato di aggiornamento di un aggiornamento del sistema operativo.
targetOsVersion

string

Nuova versione della piattaforma dell'immagine del sistema operativo scaricata e applicata. Viene impostato solo quando lo stato dell'aggiornamento è UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Tieni presente che potrebbe trattarsi di un valore fittizio "0.0.0.0" per UPDATE_STATUS_NEED_REBOOT per alcuni casi limite, ad esempio se il motore di aggiornamento viene riavviato senza un riavvio.
targetKioskAppVersion

string

Nuova versione della piattaforma richiesta dall'app kiosk aggiornata in attesa.
updateTime

string

Data e ora dell'ultimo aggiornamento del sistema operativo riuscito.
updateCheckTime

string

Data e ora dell'ultimo controllo dell'aggiornamento.
rebootTime

string

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 C'è un aggiornamento in attesa, ma non è stato avviato.
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 dello 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 deprovisioning del dispositivo è stato eseguito 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 risorse. Stai donando, smaltendo o rimuovendo in altro modo il dispositivo.
DEPROVISION_REASON_UPGRADE_TRANSFER Trasferimento dell'upgrade di ChromeOS Flex. È un dispositivo ChromeOS Flex che vuoi sostituire con Chromebook entro un anno.
DEPROVISION_REASON_NOT_REQUIRED Non è stato richiesto un motivo. Ad esempio, le licenze sono state restituite al pool di licenze del cliente.
DEPROVISION_REASON_REPAIR_CENTER Il deprovisioning del dispositivo è stato eseguito dal Centro riparazioni. Può essere impostato solo dal Repair Service Center 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 un upgrade perpetuo di Chrome Enterprise.
ENTERPRISE_UPGRADE Il dispositivo dispone di un upgrade annuale di Chrome Enterprise Upgrade in modalità autonoma.
EDUCATION_UPGRADE Il dispositivo dispone di Chrome Education Upgrade autonomo perpetuo.
EDUCATION Il dispositivo è incluso nel set con un upgrade perpetuo di Chrome Education.
KIOSK_UPGRADE Il dispositivo ha un upgrade annuale per chioschi.

BacklightInfo

Informazioni sulle retroilluminazione del dispositivo.

Rappresentazione JSON 
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Campi
path

string

Solo output. Percorso di questa retroilluminazione sul sistema. È utile se chi chiama deve associare i dati a altre informazioni.
maxBrightness

integer

Solo output. Luminosità massima della retroilluminazione.
brightness

integer

Solo output. Luminosità corrente della retroilluminazione, compresa tra 0 e maxBrightness.

FanInfo

Informazioni sulla ventola del dispositivo.

Rappresentazione JSON 
{
  "speedRpm": integer
}
Campi
speedRpm

integer

Solo output. Velocità della ventola in RPM.

ChromeOsType

Il tipo di ChromeOS del dispositivo.

Enum
CHROME_OS_TYPE_UNSPECIFIED Tipo di ChromeOS non specificato.
CHROME_OS_FLEX Tipo di ChromeOS: ChromeOS Flex.
CHROME_OS Tipo di sistema operativo ChromeOS.

ByteUsage

Rappresenta una capacità di dati con una certa quantità di utilizzo corrente in byte.

Rappresentazione JSON 
{
  "capacityBytes": string,
  "usedBytes": string
}
Campi
capacityBytes

string (int64 format)

Solo output. Il valore della capacità totale, in byte.
usedBytes

string (int64 format)

Solo output. Il valore di utilizzo corrente, in byte.

Metodi

action
(deprecated)

 Utilizza BatchChangeChromeOsDeviceStatus.

get

 Recupera le proprietà di un dispositivo ChromeOS.

list

 Recupera un elenco paginato dei dispositivi ChromeOS all'interno di un account.

moveDevicesToOu

 Sposta o inserisce più dispositivi ChromeOS in un'unità organizzativa.

patch

 Aggiorna le proprietà aggiornabili di un dispositivo, ad esempio annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

update

 Aggiorna le proprietà aggiornabili di un dispositivo, ad esempio annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.