Method: partners.devices.claim

Mengklaim perangkat untuk pelanggan dan menambahkannya ke pendaftaran zero-touch. Jika perangkat sudah diklaim oleh pelanggan lain, panggilan akan menampilkan error.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
partnerId

string (int64 format)

Wajib diisi. ID partner reseller.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "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.
}
Kolom
deviceIdentifier

object (DeviceIdentifier)

Wajib diisi. Wajib diisi. ID perangkat yang akan diklaim.
sectionType

enum (DeviceProvisioningSectionType)

Wajib diisi. Jenis bagian dari data penyediaan perangkat.
deviceMetadata

object (DeviceMetadata)

Opsional. Metadata yang akan dilampirkan ke perangkat.
preProvisioningToken

string

Opsional. Harus dan hanya dapat ditetapkan untuk perangkat Chrome OS.
Kolom union customer. Wajib diisi. Pelanggan yang perangkatnya diklaim. customer hanya dapat berupa salah satu dari berikut:
customerId

string (int64 format)

ID pelanggan yang perangkatnya diklaim.
googleWorkspaceCustomerId

string

ID pelanggan Google Workspace.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons yang berisi ID perangkat klaim.

Representasi JSON 
{
  "deviceId": string,
  "deviceName": string
}
Kolom
deviceId

string (int64 format)

ID perangkat dari perangkat yang diklaim.
deviceName

string

Nama resource perangkat dalam format partners/[PARTNER_ID]/devices/[DEVICE_ID].

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.