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.
}
الحقول
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 للجهاز.

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 Essentials. للمطالبة بجهاز مزوّد بخدمة حماية الجهاز، عليك التسجيل لدى فريق الشراكة.

الطُرق

claim

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

claimAsync

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

findByIdentifier

يعثر على الأجهزة من خلال معرّفات الأجهزة، مثل IMEI.

findByOwner

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

get

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

metadata

يعدِّل البيانات الوصفية للمورِّد المرتبطة بالجهاز.

unclaim

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

unclaimAsync

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

updateMetadataAsync

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