Method: partners.devices.claim

Müşteri için bir cihaz talep eder ve cihazı el değmeden kayıt işlemine ekler. Cihaz için zaten başka bir müşteri tarafından hak talebinde bulunulmuşsa arama bir hata döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
partnerId

string (int64 format)

Zorunlu. Bayi iş ortağının kimliği.

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "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.
}
Alanlar
deviceIdentifier

object (DeviceIdentifier)

Zorunlu. Zorunlu. Talep edilecek cihazın cihaz tanımlayıcısı.

sectionType

enum (DeviceProvisioningSectionType)

Zorunlu. Cihazın temel hazırlık kaydının bölüm türü.

deviceMetadata

object (DeviceMetadata)

İsteğe bağlı. Cihaza eklenecek meta veriler.

preProvisioningToken

string

İsteğe bağlı. Yalnızca Chrome OS cihazlar için ayarlanabilir ve ayarlanabilir.

Birlik alanı customer. Zorunlu. Cihaz için hak talebinde bulunulan müşteri. customer aşağıdakilerden yalnızca biri olabilir:
customerId

string (int64 format)

Cihaz için hak talebinde bulunulan müşterinin kimliği.

googleWorkspaceCustomerId

string

Google Workspace müşteri kimliği.

Yanıt metni

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Hak talebinin cihaz kimliğini içeren yanıt mesajı.

JSON gösterimi
{
  "deviceId": string,
  "deviceName": string
}
Alanlar
deviceId

string (int64 format)

Hak talebinde bulunulan cihazın cihaz kimliği.

deviceName

string

Cihazın partners/[PARTNER_ID]/devices/[DEVICE_ID] biçiminde kaynak adı.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.