REST Resource: partners.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)
    }
  ]
}
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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. Assegnato dal server.
deviceMetadata

object (DeviceMetadata)

I metadati associati al dispositivo. Strutturate come coppie chiave/valore. Per scoprire di più, leggi l'articolo Metadati del dispositivo.
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 partners.devices.unclaim o partners.devices.unclaimAsync per rimuovere il dispositivo dalla registrazione zero-touch.

DeviceIdentifier

Incapsula gli ID hardware e prodotto per identificare un dispositivo prodotto. Per comprendere i requisiti per gli insiemi 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.

  // 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 in diversi modelli di dispositivi.
manufacturer

string

Il nome del produttore del dispositivo. Corrisponde al valore predefinito del dispositivo restituito da android.os.Build.MANUFACTURER. I valori consentiti sono elencati in Prodottisti 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. 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 all'inserimento.
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ù, 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 coppie "key": value. 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 scoprire di più, consulta Rivendicare i dispositivi per i clienti.

Rappresentazione JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "resellerId": 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.
resellerId

string (int64 format)

L'ID del rivenditore che ha richiesto il dispositivo.
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 al servizio di protezione del dispositivo, devi registrarti con il team di partnership.

Metodi

claim

 Rivendica un dispositivo per un cliente e lo aggiunge alla registrazione zero-touch.

claimAsync

 Rivendica un batch di dispositivi per un cliente in modo asincrono.

findByIdentifier

 Trova i dispositivi in base agli identificatori hardware, ad esempio l'IMEI.

findByOwner

 Trova i dispositivi rivendicati per i clienti.

get

 Recupera un dispositivo.

metadata

 Aggiorna i metadati del rivenditore associati al dispositivo.

unclaim

 Annullare la rivendicazione di un dispositivo da parte di un cliente e rimuoverlo dalla registrazione zero-touch.

unclaimAsync

 Annullamento della rivendicazione di un batch di dispositivi per un cliente in modo asincrono.

updateMetadataAsync

 Aggiorna i metadati del rivenditore associati a un lotto di dispositivi.