REST Resource: customers.devices

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

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

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

string (int64 format)

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

object (DeviceIdentifier)

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

string

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

object (DeviceMetadata)

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

object (DeviceClaim)

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

string

الإعدادات المطبَّقة على الجهاز بالتنسيق customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] تكون القيمة null إذا لم يتم تطبيق إعدادات على الجهاز.

معرّف الجهاز

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

تمثيل 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,
  "additionalService": enum (AdditionalService)
}
الحقول
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

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

string

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

enum (AdditionalService)

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

DeviceProvisioningSectionType

نوع القسم لسجلّ التوفير

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

AdditionalService

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

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

الطُرق

applyConfiguration

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

get

 تحصل على تفاصيل جهاز.

list

 يسرد أجهزة العميل.

removeConfiguration

 إزالة إعدادات من الجهاز

unclaim

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