Method: partners.devices.claim

Müşteri için bir cihaz için hak talebinde bulunur ve cihazı el değmeden kayıt işlemine ekler. Cihaz zaten başka bir müşteri tarafından talep edilmişse 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 içeriği

İ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. Hak talebinde bulunulacak cihazın cihaz tanımlayıcısıdır.
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.
Birleştirme alanı customer. Zorunlu. Cihazla ilgili hak talebinde bulunulan müşteri. customer şunlardan yalnızca biri olabilir:
customerId

string (int64 format)

Cihazla ilgili hak talebinde bulunulan müşterinin kimliği.
googleWorkspaceCustomerId

string

Google Workspace müşteri kimliği.

Yanıt gövdesi

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çimindeki 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.