Method: partners.devices.claim

อ้างสิทธิ์อุปกรณ์ให้กับลูกค้าและเพิ่มลงในการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม หากมีการอ้างสิทธิ์โดยลูกค้ารายอื่นไปแล้ว การโทรจะแสดงข้อผิดพลาด

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
partnerId

string (int64 format)

ต้องระบุ รหัสของพาร์ทเนอร์ตัวแทนจําหน่าย

เนื้อหาของคำขอ

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง 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.
}
ช่อง
deviceIdentifier

object (DeviceIdentifier)

ต้องระบุ ต้องระบุ ตัวระบุของอุปกรณ์ที่จะอ้างสิทธิ์
sectionType

enum (DeviceProvisioningSectionType)

ต้องระบุ ประเภทส่วนของระเบียนการจัดสรรของอุปกรณ์
deviceMetadata

object (DeviceMetadata)

ไม่บังคับ ข้อมูลเมตาที่จะแนบไปกับอุปกรณ์
preProvisioningToken

string

ไม่บังคับ ต้องตั้งค่าและใช้ได้กับอุปกรณ์ Chrome OS เท่านั้น
ช่อง Union customer ต้องระบุ ลูกค้าที่ได้รับการอ้างสิทธิ์ในอุปกรณ์ customer ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
customerId

string (int64 format)

รหัสของลูกค้าที่ได้รับการอ้างสิทธิ์อุปกรณ์
googleWorkspaceCustomerId

string

รหัสลูกค้า Google Workspace

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ข้อความตอบกลับที่มีรหัสอุปกรณ์ของการอ้างสิทธิ์

การแสดง JSON 
{
  "deviceId": string,
  "deviceName": string
}
ช่อง
deviceId

string (int64 format)

รหัสอุปกรณ์ของอุปกรณ์ที่อ้างสิทธิ์
deviceName

string

ชื่อทรัพยากรของอุปกรณ์ในรูปแบบ partners/[PARTNER_ID]/devices/[DEVICE_ID]

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อภาพรวม OAuth 2.0