للمطالبة بجهاز عميل وإضافته إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". إذا سبق أن طالب عميل آخر بملكية الجهاز، ستظهر رسالة خطأ عند إجراء المكالمة.
طلب 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.