REST Resource: customers.devices

Risorsa: dispositivo

Un dispositivo Android o Chrome OS registrato per la registrazione zero-touch.

Rappresentazione JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Campi
deviceId

string (int64 format)

Solo output. L'ID del dispositivo. Assegnato dal server.
deviceIdentifier

object (DeviceIdentifier)

Gli ID hardware che identificano un dispositivo prodotto. Per scoprire di più, leggi l'articolo Identificatori.
name

string

Solo output. Il nome della risorsa API nel formato customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Assegnato dal server.
deviceMetadata

object (DeviceMetadata)

I metadati associati al dispositivo. Strutturati come coppie chiave-valore.
claims[]

object (DeviceClaim)

Solo output. Le rivendicazioni del provisioning per un dispositivo. I dispositivi rivendicati per la registrazione zero-touch hanno una rivendicazione di tipo SECTION_TYPE_ZERO_TOUCH. Chiama il numero customers.devices.unclaim per rimuovere il dispositivo dalla registrazione zero-touch.
configuration

string

La configurazione applicata al dispositivo nel formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Il valore è null se al dispositivo non è applicata una configurazione.

DeviceIdentifier

Incapsula ID hardware e prodotti per identificare un dispositivo fabbricato. Per comprendere i requisiti per i set di identificatori, leggi la sezione Identificatori.

Rappresentazione JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
Campi
serialNumber

string

Il numero di serie del produttore del dispositivo. Questo valore potrebbe non essere univoco tra modelli di dispositivi diversi.
manufacturer

string

Il nome del produttore del dispositivo. Corrisponde al valore integrato del dispositivo restituito da android.os.Build.MANUFACTURER I valori consentiti sono indicati nei produttori Android.
model

string

Il nome del modello del dispositivo. I valori consentiti sono elencati nei modelli Android e nei modelli di Chrome OS.
deviceType

enum (DeviceType)

Il tipo di dispositivo.
chromeOsAttestedDeviceId

string

Un identificatore fornito dagli OEM durante il processo di produzione e vendita. Applicabile solo ai dispositivi Chrome OS.
Campo di unione hardware_id. ID hardware basato su un ID modem. hardware_id può essere solo uno dei seguenti:
imei

string

Il numero IMEI del dispositivo. Convalidato utilizzando l'input.
meid

string

Il numero MEID del dispositivo.

Tipo di dispositivo

Il sistema operativo del dispositivo.

Enum
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo Chrome OS

Metadati dispositivo

Voci di metadati che possono essere collegate a un Device. Per scoprire di più, leggi l'articolo Metadati del dispositivo.

Rappresentazione JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Campi
entries

map (key: string, value: string)

Voci di metadati registrate come coppie chiave-valore.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Rivendicazione del dispositivo

Un record di un dispositivo rivendicato da un rivenditore per un cliente. I dispositivi rivendicati per la registrazione zero-touch hanno una rivendicazione di tipo SECTION_TYPE_ZERO_TOUCH. Per scoprire di più, leggi Richiedere i dispositivi per i clienti.

Rappresentazione JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Campi
sectionType

enum (DeviceProvisioningSectionType)

Solo output. Il tipo di rivendicazione effettuata sul dispositivo.
ownerCompanyId

string (int64 format)

L'ID del cliente che ha acquistato il dispositivo Android.
googleWorkspaceCustomerId

string

L'ID dell'account Google Workspace proprietario del dispositivo Chrome OS.
additionalService

enum (AdditionalService)

Il servizio aggiuntivo registrato per il dispositivo.

TipoProvisioningSezionesezione

Il tipo di sezione di un record di provisioning.

Enum
SECTION_TYPE_SIM_LOCK Tipo di sezione di blocco SIM.
SECTION_TYPE_ZERO_TOUCH Tipo di sezione di registrazione zero-touch.

Servizio aggiuntivo

Servizio aggiuntivo registrato per il dispositivo.

Enum
DEVICE_PROTECTION Servizio di protezione dei dispositivi, noto anche come Android Enterprise Essentials. Per rivendicare un dispositivo con il servizio di protezione dei dispositivi devi registrarti con il team responsabile della partnership.

Metodi

applyConfiguration

 Applica una configurazione al dispositivo per registrare il dispositivo per la registrazione zero-touch.

get

 Recupera i dettagli di un dispositivo.

list

 Elenca i dispositivi di un cliente.

removeConfiguration

 Rimuove una configurazione dal dispositivo.

unclaim

 Annulla la rivendicazione di un dispositivo a un cliente e lo rimuove dalla registrazione zero-touch.