REST Resource: partners.devices

المرجع: الجهاز

جهاز Android أو ChromeOS مسجَّل في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة"

تمثيل JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ]
}
الحقول
deviceId

string (int64 format)

النتائج فقط. رقم تعريف الجهاز. تم تعيينها من قِبل الخادم.
deviceIdentifier

object (DeviceIdentifier)

معرّفات الأجهزة التي تحدِّد جهازًا تم تصنيعه للمزيد من المعلومات، يُرجى الاطّلاع على المعرِّفات.
name

string

النتائج فقط. اسم مورد واجهة برمجة التطبيقات بالتنسيق partners/[PARTNER_ID]/devices/[DEVICE_ID]. تم تعيينها من قِبل الخادم.
deviceMetadata

object (DeviceMetadata)

البيانات الوصفية المرفقة بالجهاز تكون منظَّمة على شكل أزواج مفاتيح/قيم. لمزيد من المعلومات، يُرجى الاطّلاع على البيانات الوصفية للجهاز.
claims[]

object (DeviceClaim)

النتائج فقط. طلبات إدارة الجهاز تحتوي الأجهزة التي تمّت المطالبة بها من أجل إعدادها من خلال برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" على مطالبة من النوع SECTION_TYPE_ZERO_TOUCH. اتصل على partners.devices.unclaim أو partners.devices.unclaimAsync لإزالة الجهاز من برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة".

معرّف الجهاز

يتضمن هذا الحقل معرّفات الأجهزة والمنتجات لتحديد جهاز تم تصنيعه. لفهم المتطلبات المتعلقة بمجموعات المعرّفات، يُرجى الاطّلاع على المعرّفات.

تمثيل JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
الحقول
serialNumber

string

الرقم التسلسلي للشركة المصنّعة للجهاز قد لا تكون هذه القيمة فريدة في طُرز الأجهزة المختلفة.
manufacturer

string

اسم الشركة المصنّعة للجهاز تتطابق مع القيمة المضمّنة في الجهاز والتي يتم عرضها من android.os.Build.MANUFACTURER. يمكنك الاطّلاع على القيم المسموح بها في شركات تصنيع أجهزة Android.
model

string

اسم طراز الجهاز يتم إدراج القيم المسموح بها في طُرز Android وطُرز نظام التشغيل Chrome.
deviceType

enum (DeviceType)

نوع الجهاز
chromeOsAttestedDeviceId

string

معرّف يقدّمه المصنّعون الأصليون للأجهزة خلال عملية الإنتاج والمبيعات لا تسري هذه السياسة إلا على الأجهزة التي تعمل بنظام التشغيل ChromeOS.
حقل الربط hardware_id رقم تعريف الجهاز استنادًا إلى رقم تعريف المودم يمكن أن يكون hardware_id واحدًا فقط مما يلي:
imei

string

رقم IMEI للجهاز تم التحقّق من صحة البيانات عند الإدخال.
meid

string

رقم MEID للجهاز.
حقل الاتحاد hardware_id2. معرّف الجهاز الثاني لأجهزة شريحة SIM المزدوجة في حال ضبطه، يجب أن يكون من النوع نفسه المستخدَم في معرّف الجهاز الأول. يمكن أن يكون hardware_id2 واحدًا فقط مما يلي:
imei2

string

رقم IMEI الثاني للجهاز
meid2

string

رقم MEID الثاني للجهاز

DeviceType

نظام تشغيل الجهاز.

عمليات التعداد
DEVICE_TYPE_ANDROID جهاز Android
DEVICE_TYPE_CHROME_OS جهاز ChromeOS

DeviceMetadata

إدخالات البيانات الوصفية التي يمكن إرفاقها بـ Device لمزيد من المعلومات، يُرجى الاطّلاع على البيانات الوصفية للجهاز.

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

map (key: string, value: string)

إدخالات البيانات الوصفية المسجّلة كأزواج مفتاح/قيمة

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

DeviceClaim

سجلّ لجهاز طالب به مورِّد نيابةً عن عميل تحتوي الأجهزة التي تمّت المطالبة بها من أجل إعدادها من خلال برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" على مطالبة من النوع SECTION_TYPE_ZERO_TOUCH. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مطالبة العملاء بالأجهزة.

تمثيل JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
الحقول
sectionType

enum (DeviceProvisioningSectionType)

النتائج فقط. نوع المطالبة المقدَّمة على الجهاز
ownerCompanyId

string (int64 format)

رقم تعريف العميل الذي اشترى الجهاز.
googleWorkspaceCustomerId

string

رقم تعريف حساب Google Workspace الذي يملك جهاز ChromeOS
resellerId

string (int64 format)

معرّف المورّد الذي طالب بالجهاز
additionalService

enum (AdditionalService)

الخدمة الإضافية المسجَّلة للجهاز

DeviceProvisioningSectionType

نوع القسم لسجلّ إدارة الحسابات.

عمليات التعداد
SECTION_TYPE_SIM_LOCK نوع قسم قفل شريحة SIM
SECTION_TYPE_ZERO_TOUCH نوع قسم "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".

AdditionalService

خدمة إضافية مسجَّلة للجهاز

عمليات التعداد
DEVICE_PROTECTION خدمة حماية الجهاز، المعروفة أيضًا باسم "أساسيات Android Enterprise" للمطالبة بجهاز مزوّد بخدمة حماية الجهاز، عليك التسجيل لدى فريق الشراكة.

الطُرق

claim

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

claimAsync

 يطلب الجهاز مجموعة من الأجهزة للعميل بشكل غير متزامن.

findByIdentifier

 البحث عن الأجهزة حسب معرّفات الأجهزة، مثل IMEI

findByOwner

 يعثر على الأجهزة التي تم طلبها للعملاء.

get

 الحصول على جهاز

metadata

 تعديل البيانات الوصفية الخاصة بمورّد المحتوى والمرتبطة بالجهاز

unclaim

 إلغاء المطالبة بجهاز من عميل وإزالته من برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"

unclaimAsync

 إلغاء المطالبة بمجموعة من الأجهزة لعميل بشكل غير متزامن

updateMetadataAsync

 تعديل البيانات الوصفية الخاصة بالمورّد والمرفوعة مع مجموعة من الأجهزة