المرجع: جهاز جوّال
تتضمن "إدارة 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 |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى موارد الأجهزة الجوّالة، تكون القيمة هي |
etag |
علامة ETag للمورد. |
resourceId |
المعرّف الفريد الذي تستخدمه خدمة واجهة برمجة التطبيقات لتحديد الجهاز الجوّال. |
deviceId |
الرقم التسلسلي لجهاز جوَّال "مزامنة Google". بالنسبة إلى الأجهزة التي تعمل بنظامَي التشغيل Android وiOS، هذا هو معرّف فريد ينشئه البرنامج. |
name[] |
قائمة بأسماء المستخدمين التابعة للمالك. إذا كان تطبيقك يحتاج إلى القائمة الحالية لأسماء مالكي الأجهزة، استخدِم طريقة get. لمزيد من المعلومات حول استرداد معلومات مستخدم الجهاز الجوّال، يُرجى الاطّلاع على دليل مطوّر البرامج. |
email[] |
قائمة بعناوين البريد الإلكتروني للمالك. إذا كان تطبيقك يحتاج إلى القائمة الحالية لعناوين البريد الإلكتروني للمستخدمين، استخدِم طريقة get. للحصول على معلومات إضافية، يمكنك الاطّلاع على طريقة استرداد مستخدم. |
model |
اسم طراز الجهاز الجوّال، على سبيل المثال Nexus S. يمكن تعديل هذا الموقع. لمزيد من المعلومات، اطّلع على دليل المطوِّر. |
os |
نظام تشغيل الجهاز الجوّال، على سبيل المثال IOS 4.3 أو Android 2.3.5. يمكن تعديل هذا الموقع. لمزيد من المعلومات، اطّلع على دليل المطوِّر. |
type |
نوع الجهاز الجوّال. |
status |
حالة الجهاز |
hardwareId |
المعرف الفريد IMEI/MEID لأجهزة Android. ولا يسري ذلك على أجهزة "مزامنة Google". عند إضافة جهاز جوّال Android، هذه خاصية اختيارية. عند تحديث أحد هذه الأجهزة، يتم منح الإذن بالقراءة فقط. |
firstSync |
يشير هذا المصطلح إلى تاريخ ووقت مزامنة الجهاز في البداية مع إعدادات السياسات في "وحدة تحكُّم المشرف". وتكون القيمة بتنسيق ISO 8601 للتاريخ والوقت. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني على النحو التالي: |
lastSync |
تاريخ ووقت آخر مزامنة للجهاز مع إعدادات السياسات في وحدة تحكم المشرف. وتكون القيمة بتنسيق ISO 8601 للتاريخ والوقت. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني على النحو التالي: |
userAgent |
يقدّم هذا القسم معلومات عن الجهاز، مثل إصدار |
serialNumber |
الرقم التسلسلي للجهاز |
imei |
رقم IMEI للجهاز |
meid |
رقم MEID للجهاز. |
wifiMacAddress |
عنوان MAC للجهاز على شبكات Wi-Fi. |
networkOperator |
جهاز جوّال أو مشغّل شبكة الجوّال (إن توفّر) (للقراءة فقط) |
defaultLanguage |
اللغة التلقائية المستخدمة على الجهاز. |
managedAccountIsOnOwnerProfile |
قيمة منطقية تشير إلى ما إذا كان هذا الحساب تابعًا للمالك/الملف الشخصي الأساسي أم لا. |
deviceCompromisedStatus |
حالة الجهاز المُخترَق. |
buildNumber |
رقم إصدار نظام تشغيل الجهاز. |
kernelVersion |
إصدار النواة للجهاز |
basebandVersion |
إصدار النطاق الأساسي للجهاز |
unknownSourcesStatus |
تم تفعيل المصادر غير المعروفة أو إيقافها على الجهاز (للقراءة فقط) |
developerOptionsStatus |
تفعيل خيارات المطوّرين أو إيقافها على الجهاز (للقراءة فقط) |
otherAccountsInfo[] |
قائمة الحسابات المُضافة على الجهاز (للقراءة فقط) |
adbStatus |
تفعيل Adb (تصحيح أخطاء USB) أو إيقافه على الجهاز (للقراءة فقط) |
supportsWorkProfile |
الملف الشخصي للعمل متوافق على الجهاز (للقراءة فقط) |
manufacturer |
الشركة المصنّعة للجهاز الجوّال (للقراءة فقط) |
releaseVersion |
إصدار إصدار الجهاز الجوّال (للقراءة فقط) |
securityPatchLevel |
مستوى رمز تصحيح أمان الجهاز الجوّال (للقراءة فقط) |
brand |
العلامة التجارية للجهاز الجوّال (للقراءة فقط) |
bootloaderVersion |
إصدار برنامج إقلاع الجهاز الجوّال (للقراءة فقط) |
hardware |
أجهزة الجهاز الجوّال (للقراءة فقط) |
encryptionStatus |
حالة تشفير الجهاز الجوّال (للقراءة فقط) |
devicePasswordStatus |
DevicePasswordStatus (للقراءة فقط) |
privilege |
DMAgentPermission (للقراءة فقط) |
applications[] |
قائمة التطبيقات المثبّتة على جهاز Android الجوّال. ولا ينطبق ذلك على "مزامنة Google" وأجهزة iOS. تتضمن القائمة جميع تطبيقات Android التي يمكنها الوصول إلى بيانات Google Workspace. عند تحديث قائمة التطبيقات، من المهم ملاحظة أن التحديثات تحل محل القائمة الحالية. إذا كان جهاز Android يحتوي على تطبيقين حاليين وحدثت واجهة برمجة التطبيقات القائمة بخمسة تطبيقات، فستصبح الآن القائمة المحدثة لخمسة تطبيقات.
|
applications[].packageName |
اسم حزمة التطبيق. مثال: |
applications[].displayName |
هو الاسم المعروض للتطبيق. مثال: |
applications[].versionName |
اسم إصدار التطبيق. مثال: |
applications[].versionCode |
رمز إصدار التطبيق. مثال: |
applications[].permission[] |
قائمة أذونات هذا التطبيق. ويمكن أن تكون أذونات Android عادية أو تلك التي يحدّدها التطبيق، ويمكن العثور عليها في بيان Android للتطبيق. أمثلة على أذونات تطبيق "تقويم Google" هي " |
الطُرق |
|
---|---|
|
اتخاذ إجراء يؤثر في جهاز جوّال. |
|
لإزالة جهاز جوّال. |
|
لاسترداد خصائص جهاز جوّال. |
|
لاسترداد قائمة مقسّمة على صفحات لجميع أجهزة الجوّال التي يملكها المستخدم لحساب ما. |