อ้างสิทธิ์อุปกรณ์ให้กับลูกค้าและเพิ่มลงในการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม หากลูกค้ารายอื่นอ้างสิทธิ์อุปกรณ์ไปแล้ว การโทรจะแสดงข้อผิดพลาด
คำขอ HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
| partnerId | 
 ต้องระบุ รหัสของพาร์ทเนอร์ตัวแทนจำหน่าย | 
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
| การแสดง JSON | 
|---|
| { "deviceIdentifier": { object ( | 
| ช่อง | |
|---|---|
| deviceIdentifier | 
 ต้องระบุ ต้องระบุ ตัวระบุอุปกรณ์ของอุปกรณ์ที่จะอ้างสิทธิ์ | 
| sectionType | 
 ต้องระบุ ประเภทส่วนของระเบียนการจัดสรรของอุปกรณ์ | 
| deviceMetadata | 
 ไม่บังคับ ข้อมูลเมตาที่จะแนบกับอุปกรณ์ | 
| preProvisioningToken | 
 ไม่บังคับ ต้องตั้งค่าและต้องตั้งค่าสำหรับอุปกรณ์ Chrome OS เท่านั้น | 
| ช่องการรวม customerต้องระบุ ลูกค้าที่จะอ้างสิทธิ์อุปกรณ์customerต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ | |
| customerId | 
 รหัสของลูกค้าที่จะอ้างสิทธิ์อุปกรณ์ | 
| googleWorkspaceCustomerId | 
 รหัสลูกค้า Google Workspace | 
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับที่มีรหัสอุปกรณ์ของการอ้างสิทธิ์
| การแสดง JSON | 
|---|
| { "deviceId": string, "deviceName": string } | 
| ช่อง | |
|---|---|
| deviceId | 
 รหัสอุปกรณ์ของอุปกรณ์ที่อ้างสิทธิ์ | 
| deviceName | 
 ชื่อทรัพยากรของอุปกรณ์ในรูปแบบ  | 
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
- https://www.googleapis.com/auth/androidworkprovisioning
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0