للمطالبة بجهاز عميل وإضافته إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". إذا سبق أن طالب عميل آخر بملكية الجهاز، ستظهر رسالة خطأ عند إجراء المكالمة.
طلب HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
partnerId | 
                
                   
 مطلوب. رقم تعريف شريك المورِّد.  | 
              
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON | 
|---|
{ "deviceIdentifier": { object (  | 
                
| الحقول | |
|---|---|
deviceIdentifier | 
                  
                     
 مطلوب. مطلوب. معرّف الجهاز المطلوب المطالبة به.  | 
                
sectionType | 
                  
                     
 مطلوب. نوع القسم لسجلّ توفير المتطلبات اللازمة للجهاز  | 
                
deviceMetadata | 
                  
                     
 اختياريّ. البيانات الوصفية المطلوب إرفاقها بالجهاز.  | 
                
preProvisioningToken | 
                  
                     
 اختياريّ. يجب ألا يتم ضبط هذا الإعداد إلا على الأجهزة التي تعمل بنظام التشغيل ChromeOS.  | 
                
حقل الاتحاد customer. مطلوب. العميل الذي تتم المطالبة بالجهاز من أجله. يمكن أن يكون customer واحدًا فقط مما يلي: | 
                |
customerId | 
                  
                     
 رقم تعريف العميل الذي تتم المطالبة بالجهاز له.  | 
                
googleWorkspaceCustomerId | 
                  
                     
 الرقم التعريفي لعميل Google Workspace  | 
                
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ تحتوي على رقم تعريف الجهاز الخاص بالمطالبة
| تمثيل JSON | 
|---|
{ "deviceId": string, "deviceName": string }  | 
                  
| الحقول | |
|---|---|
deviceId | 
                    
                       
 رقم تعريف الجهاز المُطالَب بملكيته  | 
                  
deviceName | 
                    
                       
 اسم مورد الجهاز بالتنسيق   | 
                  
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidworkprovisioning
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.