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 เท่านั้น
ฟิลด์การรวม 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