Method: partners.devices.claim

Schaltet ein Gerät für einen Kunden aus und fügt es der Zero-Touch-Registrierung hinzu. Wenn das Gerät bereits von einem anderen Kunden beansprucht wurde, gibt der Anruf eine Fehlermeldung zurück.

HTTP-Anfrage

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
partnerId

string (int64 format)

Erforderlich. Die ID des Reseller-Partners.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
Felder
deviceIdentifier

object (DeviceIdentifier)

Erforderlich. Erforderlich. Die Geräte-ID des Geräts, das beansprucht werden soll.
sectionType

enum (DeviceProvisioningSectionType)

Erforderlich. Der Abschnittstyp des Bereitstellungseintrags des Geräts.
deviceMetadata

object (DeviceMetadata)

Optional. Die Metadaten, die an das Gerät angehängt werden sollen.
preProvisioningToken

string

Optional. Muss und kann nur für Chrome OS-Geräte festgelegt werden.
Union-Feld customer. Erforderlich. Der Kunde, für den das Gerät beansprucht wird. Für customer ist nur einer der folgenden Werte zulässig:
customerId

string (int64 format)

Die ID des Kunden, für den das Gerät beansprucht wird.
googleWorkspaceCustomerId

string

Die Google Workspace-Kundennummer.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht mit der Geräte-ID des Anspruchs.

JSON-Darstellung 
{
  "deviceId": string,
  "deviceName": string
}
Felder
deviceId

string (int64 format)

Geräte-ID des Geräts, auf das Anspruch erhoben wurde.
deviceName

string

Der Ressourcenname des Geräts im Format partners/[PARTNER_ID]/devices/[DEVICE_ID].

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/androidworkprovisioning

Weitere Informationen finden Sie in der Übersicht zu OAuth 2.0.