REST Resource: mobiledevices

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

تتضمن "إدارة 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 الجوّال. ولا ينطبق ذلك على "مزامنة Google" وأجهزة iOS. تتضمن القائمة جميع تطبيقات 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

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