المورد: 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 |
نوع مورد واجهة برمجة التطبيقات بالنسبة إلى موارد الأجهزة الجوّالة، القيمة هي |
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 جوّال ولا ينطبق ذلك على أجهزة iOS و"مزامنة Google". تتضمّن القائمة أي تطبيقات Android تصل إلى بيانات Google Workspace. عند تحديث قائمة تطبيقات، من المهم ملاحظة أنّ التحديثات تحل محل القائمة الحالية. إذا كان جهاز Android يتضمّن تطبيقَين حاليَين وواجهة برمجة التطبيقات تعدّل القائمة بإضافة خمسة تطبيقات، تكون هذه هي القائمة المعدّلة التي تتضمّن خمسة تطبيقات.
|
applications[].packageName |
اسم حزمة التطبيق مثال: |
applications[].displayName |
الاسم المعروض للتطبيق. مثال: |
applications[].versionName |
اسم إصدار التطبيق. على سبيل المثال، |
applications[].versionCode |
رمز إصدار التطبيق. مثال: |
applications[].permission[] |
قائمة أذونات هذا التطبيق يمكن أن يكون هذا الإذن إما إذنًا عاديًا من Android أو إذنًا يحدّده التطبيق، ويمكن العثور عليه في بيان Android للتطبيق. تشمل أمثلة أذونات تطبيق "تقويم Google" |
الطُرق |
|
---|---|
|
يتخذ إجراءً يؤثر في جهاز جوّال. |
|
إزالة جهاز جوّال |
|
يسترجع خصائص جهاز جوّال. |
|
لاسترداد قائمة مقسّمة إلى صفحات تضم جميع الأجهزة الجوّالة المملوكة للمستخدم للحساب. |