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. 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. Wajib. ID perangkat dari perangkat yang akan diklaim.

sectionType

enum (DeviceProvisioningSectionType)

Wajib. Jenis bagian dari data penyediaan perangkat.

deviceMetadata

object (DeviceMetadata)

Opsional. Metadata yang akan dilampirkan ke perangkat.

preProvisioningToken

string

Opsional. Harus dan hanya dapat disetel untuk perangkat Chrome OS.

Kolom union customer. Wajib. Pelanggan yang perangkatnya sedang diklaim. customer hanya dapat berupa salah satu dari berikut:
customerId

string (int64 format)

ID pelanggan untuk perangkat yang diklaim.

googleWorkspaceCustomerId

string

ID pelanggan Google Workspace.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan tanggapan 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:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.