REST Resource: partners.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)
    }
  ]
}
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 collegati al dispositivo. Strutturati come coppie chiave-valore. Per scoprire di più, consulta Metadati del dispositivo.
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 partners.devices.unclaim o partners.devices.unclaimAsync per rimuovere il dispositivo dalla registrazione zero-touch.

DeviceIdentifier

Incapsula l'hardware e gli ID prodotto per identificare un dispositivo fabbricato. 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,
  "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 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

claim

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

claimAsync

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

findByIdentifier

 Individua i dispositivi in base a identificatori hardware, come l'IMEI.

findByOwner

 Trova i dispositivi richiesti per i clienti.

get

 Recupera un dispositivo.

metadata

 Aggiorna i metadati del rivenditore associati al dispositivo.

unclaim

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

unclaimAsync

 Consente di annullare la rivendicazione di un gruppo di dispositivi per un cliente in modo asincrono.

updateMetadataAsync

 Aggiorna i metadati del rivenditore collegati a un gruppo di dispositivi.