REST Resource: mobiledevices

المورد: MobileDevice

تشمل خدمة "إدارة الأجهزة الجوّالة في Google Workspace" أجهزة Android ومزامنة Google وiOS. لمزيد من المعلومات عن المهام الشائعة لواجهة برمجة التطبيقات للأجهزة الجوّالة للمجموعات، يُرجى الاطّلاع على دليل المطوّر.

تمثيل JSON
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات بالنسبة إلى موارد الأجهزة الجوّالة، القيمة هي admin#directory#mobiledevice.

etag

string

علامة ETag للمورد.

resourceId

string

المعرّف الفريد الذي تستخدمه خدمة واجهة برمجة التطبيقات لتحديد الجهاز الجوّال.

deviceId

string

الرقم التسلسلي لجهاز جوّال يستخدم خدمة "مزامنة Google" بالنسبة إلى أجهزة Android وiOS، هذا هو معرّف فريد يتم إنشاؤه بواسطة البرامج.

name[]

string

قائمة بأسماء المستخدمين للمالك. إذا كان تطبيقك يحتاج إلى القائمة الحالية لأسماء مالكي الأجهزة، استخدِم طريقة get. لمزيد من المعلومات عن استرداد معلومات مستخدمي الأجهزة الجوّالة، يُرجى الاطّلاع على دليل المطوّر.

email[]

string

قائمة عناوين البريد الإلكتروني الخاصة بالمالك إذا كان تطبيقك يحتاج إلى القائمة الحالية لعناوين البريد الإلكتروني للمستخدمين، استخدِم الطريقة get. للحصول على معلومات إضافية، اطّلِع على طريقة استرداد مستخدم.

model

string

اسم طراز الجهاز الجوّال، على سبيل المثال Nexus S يمكن تعديل هذه السمة. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوِّر.

os

string

نظام تشغيل الجهاز الجوّال، على سبيل المثال، IOS 4.3 أو Android 2.3.5 يمكن تعديل هذه السمة. لمزيد من المعلومات، يمكنك الاطّلاع على دليل المطوِّر.

type

string

نوع الجهاز الجوّال

status

string

حالة الجهاز

hardwareId

string

معرّف IMEI/MEID الفريد لأجهزة Android لا ينطبق على أجهزة مزامنة Google. عند إضافة جهاز Android جوّال، يكون هذا الحقل اختياريًا. عند تعديل أحد هذه الأجهزة، تكون هذه السمة للقراءة فقط.

firstSync

string

يشير هذا الحقل إلى تاريخ ووقت مزامنة الجهاز في البداية مع إعدادات السياسة في "وحدة تحكّم المشرف". تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. على سبيل المثال، 2010-04-05T17:30:04+01:00.

lastSync

string

يشير هذا الحقل إلى تاريخ ووقت آخر مزامنة للجهاز مع إعدادات السياسات في "وحدة تحكّم المشرف". تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مع الساعات والدقائق والثواني بالتنسيق <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. على سبيل المثال، 2010-04-05T17:30:04+01:00.

userAgent

string

يوفّر معلومات عن الجهاز، مثل إصدار os. يمكن تعديل هذه السمة. لمزيد من المعلومات، يمكنك الاطّلاع على دليل المطوِّر.

serialNumber

string

الرقم التسلسلي للجهاز

imei

string

رقم IMEI للجهاز

meid

string

رقم MEID للجهاز

wifiMacAddress

string

عنوان MAC للجهاز على شبكات Wi-Fi.

networkOperator

string

مشغِّل شبكة الجوّال أو مشغِّل شبكة الجهاز الجوّال (إذا كان متاحًا) (للقراءة فقط)

defaultLanguage

string

اللغة التلقائية المستخدَمة على الجهاز

managedAccountIsOnOwnerProfile

boolean

قيمة منطقية تشير إلى ما إذا كان هذا الحساب في الملف الشخصي للمالك/الأساسي أم لا

deviceCompromisedStatus

string

حالة الجهاز المُخترَق

buildNumber

string

رقم إصدار نظام تشغيل الجهاز

kernelVersion

string

إصدار نواة الجهاز

basebandVersion

string

إصدار النطاق الأساسي للجهاز

unknownSourcesStatus

boolean

تم تفعيل مصادر غير معروفة أو إيقافها على الجهاز (للقراءة فقط)

developerOptionsStatus

boolean

خيارات المطوّر مفعّلة أو غير مفعّلة على الجهاز (للقراءة فقط)

otherAccountsInfo[]

string

قائمة الحسابات المُضافة على الجهاز (للقراءة فقط)

adbStatus

boolean

تفعيل Adb (تصحيح أخطاء الجهاز عبر USB) أو إيقافه على الجهاز (للقراءة فقط)

supportsWorkProfile

boolean

ملف العمل متوافق على الجهاز (للقراءة فقط)

manufacturer

string

الشركة المصنّعة للجهاز الجوّال (للقراءة فقط)

releaseVersion

string

إصدار الجهاز الجوّال (للقراءة فقط)

securityPatchLevel

string (int64 format)

مستوى رمز تصحيح أمان الجهاز الجوّال (للقراءة فقط)

brand

string

العلامة التجارية للجهاز الجوّال (للقراءة فقط)

bootloaderVersion

string

إصدار برنامج الإقلاع لجهاز الجوّال (للقراءة فقط)

hardware

string

مكونات الجهاز الجوّال (للقراءة فقط)

encryptionStatus

string

حالة تشفير جهاز الجوّال (للقراءة فقط)

devicePasswordStatus

string

DevicePasswordStatus (للقراءة فقط)

privilege

string

DMAgentPermission (للقراءة فقط)

applications[]

object

قائمة التطبيقات المثبَّتة على جهاز Android جوّال ولا ينطبق ذلك على أجهزة iOS و"مزامنة Google". تتضمّن القائمة أي تطبيقات Android تصل إلى بيانات Google Workspace.

عند تحديث قائمة تطبيقات، من المهم ملاحظة أنّ التحديثات تحل محل القائمة الحالية. إذا كان جهاز Android يتضمّن تطبيقَين حاليَين وواجهة برمجة التطبيقات تعدّل القائمة بإضافة خمسة تطبيقات، تكون هذه هي القائمة المعدّلة التي تتضمّن خمسة تطبيقات.

applications[].packageName

string

اسم حزمة التطبيق مثال: com.android.browser.

applications[].displayName

string

الاسم المعروض للتطبيق. مثال: Browser.

applications[].versionName

string

اسم إصدار التطبيق. على سبيل المثال، 3.2-140714.

applications[].versionCode

integer

رمز إصدار التطبيق. مثال: 13.

applications[].permission[]

string

قائمة أذونات هذا التطبيق يمكن أن يكون هذا الإذن إما إذنًا عاديًا من Android أو إذنًا يحدّده التطبيق، ويمكن العثور عليه في بيان Android للتطبيق. تشمل أمثلة أذونات تطبيق "تقويم Google" READ_CALENDAR أو MANAGE_ACCOUNTS.

الطُرق

action

يتخذ إجراءً يؤثر في جهاز جوّال.

delete

إزالة جهاز جوّال

get

يسترجع خصائص جهاز جوّال.

list

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