تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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 ] } ] }

تمثيل 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`	لاسترداد قائمة مقسّمة إلى صفحات تضم جميع الأجهزة الجوّالة المملوكة للمستخدم للحساب.

REST Resource: mobiledevices

المرجع: MobileDevice

الطُرق

`action`

`delete`

`get`

`list`