Method: partners.devices.claim

Fordern Sie ein Gerät für einen Kunden an und fügen es der Zero-Touch-Registrierung hinzu. Wenn das Gerät bereits von einem anderen Kunden beansprucht wurde, gibt der Aufruf einen Fehler 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. Diese Einstellung 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)

Die Geräte-ID des beanspruchten Geräts.
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 über OAuth 2.0.