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