REST Resource: chromeosdevices

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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
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 accettati sono:

  • ACTIVE: il dispositivo è registrato nel dominio.
  • DELINQUENT: la licenza annuale per il dominio è scaduta e il dispositivo non riceve più criteri e impostazioni. All'acquisto di 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, il dispositivo verrà ACTIVE.
  • DEPROVISIONED: il dispositivo non è più idoneo per la registrazione nel dominio. L'ordine è stato annullato. Le impostazioni del dispositivo sono state memorizzate nella cache sul dispositivo. Se il dispositivo viene riattivato, verranno applicate le impostazioni di sistema più recenti a questo dispositivo appena attivato.
  • DISABLED: il dispositivo è stato disattivato dall'amministratore e non può essere utilizzato.
  • INACTIVE: il dispositivo non è registrato nel dominio.
  • RETURN_ARRIVED: la richiesta di sostituzione di questo dispositivo è arrivata.
  • RETURN_REQUESTED: è stata fatta 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 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 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 di data e ora ISO 8601. L'ora corrisponde alla 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 indicato 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 ricercata con il parametro query del metodo list. La lunghezza massima è di 500 caratteri. Sono consentiti valori vuoti.
model

string

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

string

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

string

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

boolean

Consente di stabilire se il dispositivo rinnoverà automaticamente il supporto dopo la data di fine del supporto. 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: lo switch hardware dello sviluppatore del dispositivo è attivo. All'avvio, il dispositivo ha una shell della riga di comando. Per un esempio di passaggio di uno sviluppatore, leggi le Informazioni per gli sviluppatori di Chromebook.
lastEnrollmentTime

string

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 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 accettati 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 di 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 indicato 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 del disco
diskVolumeReports[].volumeInfo[].volumeId

string

ID volume
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

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

string (int64 format)

Spazio libero su disco [in byte]
systemRamTotal

string (int64 format)

RAM totale del dispositivo in byte
cpuStatusReports[]

object

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

string

La data e l'ora in cui il report è stato ricevuto.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

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

integer

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

string

Etichetta CPU
cpuInfo[]

object

Informazioni relative alle specifiche della CPU nel dispositivo.
cpuInfo[].model

string

Il nome del modello di 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

Frequenza massima di esecuzione della CPU, per criterio.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frequenza attuale di esecuzione della CPU.
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 sulla quantità di memoria RAM disponibile (sola lettura)
systemRamFreeReports[].reportTime

string

La data e l'ora in cui il report è stato ricevuto.
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

string (int64 format)

(Sola lettura) Il timestamp dopo il quale il dispositivo smetterà di ricevere aggiornamenti o assistenza di Chrome
ethernetMacAddress0

string

(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

string

(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

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 per l'amministrazione.
tpmVersionInfo

object

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

string

la famiglia TPM. Utilizziamo la codifica di 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. Vedi le specifiche della libreria per TPM 2.0 e le specifiche principali per TPM 1.2.
tpmVersionInfo.manufacturer

string

Codice produttore TPM.
tpmVersionInfo.tpmModel

string

Numero di modello TPM.
tpmVersionInfo.firmwareVersion

string

Versione firmware TPM.
tpmVersionInfo.vendorSpecific

string

Informazioni specifiche sul fornitore, ad esempio 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 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

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)

(Sola lettura) Motivo del deprovisioning.
deviceLicenseType

enum (DeviceLicenseType)

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

object (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 (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Campi
state

enum (UpdateState)

Lo stato di un aggiornamento del sistema operativo.
targetOsVersion

string

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

string

Nuova versione della piattaforma obbligatoria 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 degli aggiornamenti.
rebootTime

string

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

string

Solo output. Percorso di questa retroilluminazione del sistema. Utile se il chiamante ha bisogno di essere correlato ad altre informazioni.
maxBrightness

integer

Solo output. Luminosità massima per la retroilluminazione.
brightness

integer

Solo output. Luminosità attuale della retroilluminazione, compresa tra 0 e maxLuminosità.

Metodi

action
(deprecated)

 Utilizza BatchChangeChromeOsDeviceStatus.

get

 Recupera le proprietà di un dispositivo ChromeOS.

list

 Recupera un elenco impaginato di 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, come annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

update

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