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

اختياريّ. يجب ألا يتم ضبط هذا الإعداد إلا على الأجهزة التي تعمل بنظام التشغيل ChromeOS.

حقل الاتحاد 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.