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

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