Method: partners.devices.claim

يطالب الجهاز بجهاز عميل ويضيفه إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". إذا تمت المطالبة بالجهاز من قبل عميل آخر، تعرض المكالمة خطأً.

طلب HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

يستخدم عنوان URL بنية تحويل ترميز gRPC.

معلمات المسار

المعلَمات
partnerId

string (int64 format)

مطلوبة. رقم تعريف الشريك المورّد

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
الحقول
deviceIdentifier

object (DeviceIdentifier)

مطلوبة. مطلوبة. معرّف الجهاز المطلوب المطالبة به.
sectionType

enum (DeviceProvisioningSectionType)

مطلوبة. نوع القسم من سجل إدارة حسابات الجهاز.
deviceMetadata

object (DeviceMetadata)

اختياريّ. البيانات الوصفية المُرفقة بالجهاز
preProvisioningToken

string

اختياريّ. يجب ضبط هذا الإعداد ويجب ضبطه فقط للأجهزة التي تعمل بنظام التشغيل Chrome.
حقل الاتحاد customer. مطلوبة. العميل الذي تتم المطالبة بالجهاز نيابة عنه. يمكن أن يكون customer واحدًا مما يلي فقط:
customerId

string (int64 format)

رقم تعريف العميل الذي تتم المطالبة بملكية الجهاز له
googleWorkspaceCustomerId

string

الرقم التعريفي لعميل Google Workspace

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة رد تحتوي على رقم تعريف الجهاز للمطالبة.

تمثيل JSON 
{
  "deviceId": string,
  "deviceName": string
}
الحقول
deviceId

string (int64 format)

رقم تعريف الجهاز المُطالَب بملكيته
deviceName

string

اسم مورد الجهاز بالتنسيق partners/[PARTNER_ID]/devices/[DEVICE_ID].

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidworkprovisioning

لمزيد من المعلومات، راجع نظرة عامة على OAuth 2.0.