REST Resource: customers.devices

المورد: الجهاز

جهاز يعمل بنظام التشغيل Android أو Chrome ويتم تسجيله في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".

تمثيل 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.
}
الحقول
serialNumber

string

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

string

اسم الشركة المصنّعة للجهاز. تتطابق مع القيمة المضمَّنة للجهاز التي تم عرضها من android.os.Build.MANUFACTURER. يتم إدراج القيم المسموح بها في الشركات المصنِّعة لنظام التشغيل Android.
model

string

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

enum (DeviceType)

نوع الجهاز
chromeOsAttestedDeviceId

string

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

string

رقم IMEI للجهاز تم التحقق من الإدخال.
meid

string

رقم MEID للجهاز.

نوع الجهاز

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

عمليات التعداد
DEVICE_TYPE_ANDROID جهاز Android
DEVICE_TYPE_CHROME_OS جهاز يعمل بنظام التشغيل Chrome

البيانات الوصفية للجهاز

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

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

map (key: string, value: string)

يتم تسجيل إدخالات البيانات الوصفية على هيئة أزواج المفتاح/القيمة.

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

مطالبة الجهاز

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

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

enum (DeviceProvisioningSectionType)

الإخراج فقط. نوع المطالبة التي تم إجراؤها على الجهاز.
ownerCompanyId

string (int64 format)

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

string

رقم تعريف حساب Google Workspace الذي يملك الجهاز الذي يعمل بنظام التشغيل Chrome.
additionalService

enum (AdditionalService)

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

إدارة الحسابات للجهاز

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

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

خدمة إضافية

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

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

الطُرق

applyConfiguration

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

get

 الحصول على تفاصيل أحد الأجهزة.

list

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

removeConfiguration

 لإزالة تهيئة من الجهاز.

unclaim

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