REST Resource: customers.devices

Risorsa: Dispositivo

Un dispositivo Android o ChromeOS 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 collegati al dispositivo. Strutturati come coppie chiave-valore.

claims[]

object (DeviceClaim)

Solo output. Le richieste di provisioning per un dispositivo. I dispositivi per i quali è stata richiesta 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 è 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.
}
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, durante il processo di produzione e vendita. Il problema riguarda solo i 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

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 per i quali è stata richiesta la registrazione zero-touch hanno una rivendicazione di tipo SECTION_TYPE_ZERO_TOUCH. Per scoprire di più, consulta 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 Android.

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 blocco SIM.
SECTION_TYPE_ZERO_TOUCH Tipo di sezione 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 al 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.