Method: partners.devices.claimAsync
Mengklaim sejumlah perangkat untuk pelanggan secara asinkron. Menambahkan perangkat ke pendaftaran zero-touch. Untuk mempelajari lebih lanjut, baca Operasi batch yang berjalan lama.
Permintaan HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
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 |
{
"claims": [
{
object (PartnerClaim)
}
]
} |
| Kolom |
claims[] |
object (PartnerClaim)
Wajib. Daftar klaim perangkat.
|
Isi respons
Jika berhasil, isi respons memuat instance Operation.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/androidworkprovisioning
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
PartnerClaim
Mengidentifikasi satu permintaan klaim.
| 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.
|
sectionType |
enum (DeviceProvisioningSectionType)
Wajib. Jenis bagian dari data penyediaan perangkat.
|
deviceMetadata |
object (DeviceMetadata)
Wajib. Metadata yang akan dilampirkan ke perangkat saat klaim.
|
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.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2024-08-29 UTC."],[[["This endpoint `POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync` enables partners to asynchronously claim a batch of devices for a customer, adding them to zero-touch enrollment."],["The request requires a `partnerId` path parameter, which is the reseller partner's ID, and a request body with a list of device claims within the `claims` field."],["Each device claim is identified by a `PartnerClaim` object, which contains the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and a customer identifier in the form of `customerId` or `googleWorkspaceCustomerId`."],["The `PartnerClaim` object optionally includes a `preProvisioningToken` and is required to complete the request."],["A successful request returns an `Operation` object, indicating that the long-running operation has been initiated."]]],["This outlines how to claim devices for a customer asynchronously via the Android zero-touch enrollment API. Use a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync`, providing the required `partnerId`. The request body, structured in JSON, includes a list of device `claims` with each claim containing the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and the required customer's ID (`customerId` or `googleWorkspaceCustomerId`). The `preProvisioningToken` field is required only for ChromeOS devices. The response body contains an `Operation`.\n"]]
