อ้างสิทธิ์อุปกรณ์ให้กับลูกค้าและเพิ่มลงในการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม หากลูกค้ารายอื่นอ้างสิทธิ์อุปกรณ์ไปแล้ว การโทรจะแสดงข้อผิดพลาด
คำขอ 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