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 saperne di più, consulta 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. Strutturate come coppie chiave/valore.
claims[]

object (DeviceClaim)

Solo output. Le richieste di provisioning per un dispositivo. I dispositivi rivendicati per la registrazione zero-touch hanno una rivendicazione di tipo SECTION_TYPE_ZERO_TOUCH. Chiama 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 è stata applicata una configurazione.

DeviceIdentifier

Incapsula l'hardware e gli ID prodotto per identificare il dispositivo prodotto. Per comprendere i requisiti degli insiemi di identificatori, consulta 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.

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

string

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

string

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

string

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

enum (DeviceType)

Il tipo di dispositivo
chromeOsAttestedDeviceId

string

Un identificatore fornito dagli OEM, che viene inserito nel processo di produzione e vendita. Applicabile solo ai dispositivi ChromeOS.
Campo 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 al momento dell'input.
meid

string

Il numero MEID del dispositivo.
Campo unione hardware_id2. Il secondo ID hardware, per i dispositivi dual SIM. Se impostato, deve essere dello stesso tipo di identificatore del primo ID hardware. hardware_id2 può essere solo uno dei seguenti:
imei2

string

Il secondo numero IMEI del dispositivo.
meid2

string

Il secondo numero MEID del dispositivo.

DeviceType

Il sistema operativo del dispositivo.

Enum
DEVICE_TYPE_ANDROID Dispositivo Android
DEVICE_TYPE_CHROME_OS Dispositivo ChromeOS

DeviceMetadata

Voci di metadati che possono essere collegate a un elemento Device. Per scoprire di più, consulta 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" }.

DeviceClaim

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 saperne di più, leggi l'articolo Rivendicare 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 presentata sul dispositivo.
ownerCompanyId

string (int64 format)

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

string

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

enum (AdditionalService)

Il servizio aggiuntivo registrato per il dispositivo.

DeviceProvisioningSectionType

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.

AdditionalService

Servizio aggiuntivo registrato per il dispositivo.

Enum
DEVICE_PROTECTION Servizio di protezione del dispositivo, noto anche come Android Enterprise Essentials. Per richiedere un dispositivo con il servizio di protezione del dispositivo, devi registrarti con il team di partnership.

Metodi

applyConfiguration

 Applica una configurazione al dispositivo per registrarlo 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

 Consente di annullare la rivendicazione di un dispositivo per un cliente e di rimuoverlo dalla registrazione zero-touch.