REST Resource: chromeosdevices

Risorsa: ChromeOsDevice

I dispositivi Google Chrome vengono eseguiti su Chrome OS. Per saperne di più sulle attività API comuni, 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)
}
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. Quando si acquista una nuova licenza, il dispositivo torna allo stato ACTIVE.
  • PRE_PROVISIONED: il dispositivo è stato registrato per la registrazione zero-touch. È possibile spostare un dispositivo PRE_PROVISIONED in un'altra unità organizzativa o eliminarlo. Al termine della registrazione il dispositivo sarà 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. Se il dispositivo viene riattivato, al dispositivo appena attivato vengono applicate le impostazioni di sistema più recenti.
  • 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 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 di data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel modulo 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 è la data completa più ore, minuti e secondi nel modulo 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 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, la proprietà non è inclusa nella risposta.

meid

string

Il codice MEID (Mobile Equipment Identifier) o l'IMEI (International Mobile Equipment Identity) della scheda mobile 3G in un dispositivo mobile. In genere, un MEID/IMEI viene utilizzato quando si aggiunge 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 maggiori informazioni 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

Determina 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, queste 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'interruttore hardware sviluppatore del dispositivo è attivo. All'avvio, il dispositivo ha una shell della riga di comando. Per un esempio di passaggio per sviluppatori, consulta 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 è la data completa più ore, minuti e secondi nel modulo YYYY-MM-DDThh:mm:ssTZD. Ad esempio: 2010-04-05T17:30:04+01:00. Per ulteriori informazioni sulla registrazione automatica e manuale, consulta il Centro assistenza Chrome.

kind

string

Il tipo di risorsa. Per la risorsa Dispositivi Chrome, il valore è admin#directory#chromeosdevice.

recentUsers[]

object

Un elenco degli 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 come 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 di dischi

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 sul dispositivo in byte

cpuStatusReports[]

object

Report sull'utilizzo e sulla temperatura della CPU (sola lettura)

cpuStatusReports[].reportTime

string

Data e ora in cui è stato ricevuto il report.

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 CPU

cpuInfo[]

object

Informazioni sulle specifiche della CPU del dispositivo.

cpuInfo[].model

string

Il nome del modello 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 alla quale è consentita l'esecuzione della CPU, in base al criterio.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frequenza attuale a cui è in esecuzione la CPU.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tempo di inattività dall'ultimo avvio.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

cpuInfo[].logicalCpus[].cStates[]

object

Gli stati C indicano lo stato del 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.

Durata in secondi con un massimo di nove cifre frazionarie e 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 per il download del file

deviceFiles[].createTime

string

Data e ora in cui è stato creato il file

systemRamFreeReports[]

object

Report sulle quantità di memoria RAM disponibile (sola lettura)

systemRamFreeReports[].reportTime

string

Data e ora in cui è stato ricevuto il report.

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 della rete WAN.

autoUpdateExpiration
(deprecated)

string (int64 format)

(Sola lettura) Il timestamp dopo il quale il dispositivo non riceverà più aggiornamenti o assistenza di Chrome. Utilizza "autoUpdatethrough" .

ethernetMacAddress0

string

Indirizzo MAC (sola lettura) utilizzato dalla porta Ethernet interna del Chromebook e per l'interfaccia di rete di bordo (Ethernet). Il formato è di dodici (12) cifre esadecimali senza delimitatore (lettere maiuscole). Questo vale solo per alcuni dispositivi.

dockMacAddress

string

(Sola lettura) Indirizzo MAC integrato per la docking station a cui si è connesso il dispositivo. L'impostazione di fabbrica consente di impostare l'indirizzo MAC (Media Access Control) per l'utilizzo da parte di un dock. È riservato specificamente ai criteri relativi ai dispositivi pass-through MAC. Il formato è di dodici (12) cifre esadecimali senza delimitatore (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 associato 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, consulta il Centro assistenza per gli amministratori.

tpmVersionInfo

object

Trusted Platform Module (TPM) (sola lettura)

tpmVersionInfo.family

string

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. Consultare Specifiche della libreria per TPM 2.0 e Specifiche principali per TPM 1.2.

tpmVersionInfo.manufacturer

string

Codice produttore TPM.

tpmVersionInfo.tpmModel

string

Numero di modello del TPM.

tpmVersionInfo.firmwareVersion

string

Versione 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 per il download del file

screenshotFiles[].createTime

string

Data e ora in cui è stato creato il 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 è 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, consulta il Centro assistenza per gli amministratori.

osUpdateStatus

object (OsUpdateStatus)

Lo stato degli aggiornamenti del sistema operativo per il dispositivo.

firstEnrollmentTime

string

La data e l'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.

autoUpdateThrough

string

Solo output. Il timestamp dopo il quale il dispositivo non riceverà più aggiornamenti o assistenza di Chrome.

extendedSupportEligible

boolean

Solo output. Se il dispositivo richiede o meno l'attivazione del supporto esteso.

extendedSupportStart

string

Solo output. Data del dispositivo nell'ora di inizio dei criteri di supporto esteso per gli aggiornamenti automatici.

extendedSupportEnabled

boolean

Solo output. Se i criteri di supporto esteso sono abilitati sul dispositivo.

fanInfo[]

object (FanInfo)

Solo output. Informazioni sulla ventola del dispositivo.

chromeOsType

enum (ChromeOsType)

Solo output. Tipo di ChromeOS del dispositivo.

OsUpdateStatus

Contiene informazioni relative allo 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 un aggiornamento del sistema operativo.

targetOsVersion

string

Nuova versione della piattaforma dell'immagine del sistema operativo che viene scaricata e applicata. È impostata solo quando lo stato dell'aggiornamento è UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Tieni presente che potrebbe essere un "0.0.0.0" fittizio per UPDATE_STATUS_NEED_REBOOT per alcuni casi limite, ad esempio e il motore di aggiornamento viene riavviato senza 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

La data e l'ora dell'ultimo controllo dell'aggiornamento.

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, ma non è stato avviato.
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. Disponi dell'autorizzazione alla restituzione dei materiali (RMA) o stai sostituendo in garanzia un dispositivo che non funziona correttamente con lo stesso modello di dispositivo.
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 del dispositivo è scaduto.

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, scartando o rimuovendo in altro modo il dispositivo dall'uso.
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 è 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 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 è fornito in bundle con Chrome Enterprise Upgrade perpetuo.
ENTERPRISE_UPGRADE Il dispositivo dispone di una licenza Chrome Enterprise Upgrade annuale autonoma.
EDUCATION_UPGRADE Il dispositivo dispone di una versione Chrome Education Upgrade autonoma perpetua.
EDUCATION Il dispositivo viene fornito in bundle con una licenza Chrome Education Upgrade perpetua.
KIOSK_UPGRADE Il dispositivo dispone di un upgrade annuale a kiosk.

BacklightInfo

Informazioni sulla retroilluminazione del dispositivo.

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

string

Solo output. Percorso della retroilluminazione del sistema. Utile se il chiamante deve essere correlato ad altre informazioni.

maxBrightness

integer

Solo output. Luminosità massima per la 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

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 ChromeOS: ChromeOS.

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.