للحصول على قائمة بالأساليب لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.
تمثيلات الموارد
يمثّل مورد "الأجهزة" جهازًا جوّالاً تديره خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) وينتمي إلى مستخدم معيّن في المؤسسة.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string, "policyId": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
androidId |
string |
معرّف Android لخدمة "خدمات Google Play" للجهاز، وهو مُشفَّر على شكل سلسلة سداسية عشرية بتنسيق أحرف أبجدية صغيرة. مثلاً: "123456789abcdef0" |
|
device |
string |
الاسم الرمزي الداخلي للجهاز هذه الرسالة واردة من android.os.Build.DEVICE . (الحقل باسم "device" لكل السجلات/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
الملف المرجعي للإصدار الخاص بالجهاز إذا كان معروفًا | |
maker |
string |
الشركة المصنّعة للجهاز. هذه الرسالة واردة من android.os.Build.MANUFACTURER . |
|
managementType |
string |
تحدِّد هذه السياسة مدى التحكُّم في الجهاز من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM) في "Google Play للأعمال" في إعدادات النشر المختلفة. تشمل القيم المحتملة ما يلي:
القيم المقبولة هي:
|
|
model |
string |
اسم طراز الجهاز هذه الرسالة واردة من android.os.Build.MODEL . |
|
policy |
nested object |
يتم فرض السياسة على الجهاز. | |
policy.autoUpdatePolicy |
string |
تتحكّم هذه السياسة في الحالات التي يمكن فيها تطبيق التحديثات التلقائية للتطبيقات على الجهاز. البديل المقترَح: autoUpdateMode الذي يتم ضبطه لكل تطبيق، يوفر مرونة أكبر في ما يتعلّق بمعدل تكرار التحديثات. عند ضبط " autoUpdateMode " على "AUTO_UPDATE_POSTPONED " أو "AUTO_UPDATE_HIGH_PRIORITY "، لن يكون لـ "autoUpdatePolicy " أي تأثير. "choiceToTheUser" يسمح لمستخدم الجهاز بضبط سياسة تحديث التطبيقات. يؤدي اختيار "دائمًا" إلى تفعيل التحديثات التلقائية. "أبدًا" لإيقاف التحديثات التلقائية. لا تفعِّل القيمة "wifiOnly" التحديثات التلقائية إلا عندما يكون الجهاز متصلاً بشبكة Wi-Fi. في ما يلي القيم المقبولة:
|
|
policy.deviceReportPolicy |
string |
يمكنك اختيار ما إذا كان الجهاز سيرسل حالة التطبيق إلى إدارة الخدمات الجوّالة للمؤسسات (EMM). القيمة التلقائية هي "deviceReportDisabled".
في ما يلي القيم المقبولة:
|
|
policy.maintenanceWindow |
nested object |
نافذة الصيانة التي تحدّد وقت تحديث التطبيقات التي تعمل في المقدّمة | |
policy.maintenanceWindow.durationMs |
long |
مدة فترة الصيانة، بالمللي ثانية يجب أن تكون المدة بين 30 دقيقة و24 ساعة (ضمنًا). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
وقت بدء فترة الصيانة، بالملي ثانية بعد منتصف الليل على الجهاز يمكن أن تمتد الفترات الزمنية إلى منتصف الليل. | |
policy.policyId |
string |
معرّف للسياسة التي سيتم تمريرها مع ملاحظات تثبيت التطبيق المُرسَلة من "متجر Play". | |
policy.productAvailabilityPolicy |
string |
مدى التوفّر الممنوح للجهاز للمنتجات المحدّدة. تمنح القيمة "all" الجهاز إذن الوصول إلى جميع المنتجات، بصرف النظر عن حالة الموافقة. "الكل" لا يؤدي إلى تفعيل الرؤية التلقائية لـ "alpha" أو "تجريبي" المسارات. "القائمة البيضاء" لمنح الجهاز إمكانية الوصول إلى المنتجات المحددة في productPolicy[]. يمكن فقط إضافة المنتجات التي تمت الموافقة عليها أو المنتجات التي تمت الموافقة عليها سابقًا من قِبل المؤسسة (المنتجات التي تم إبطال الموافقة عليها) إلى القائمة البيضاء. إذا لم يتم تقديم أي قيمة، يتم تلقائيًا تطبيق مدى التوفّر المحدّد على مستوى المستخدم.
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[] |
list |
قائمة سياسات المنتجات. يجب ضبط سمة productAvailabilityPolicy على WHITELIST أو ALL ليتم تطبيق سياسات المنتجات. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
سياسة التثبيت التلقائي للمنتج. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
القيود المفروضة على التثبيت التلقائي للتطبيق. يمكنك تحديد قيد واحد كحد أقصى. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
قيد حالة الشحن
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
قيد حالة عدم النشاط للجهاز
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
قيد نوع الشبكة
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
وضع التثبيت التلقائي في حال عدم ضبط القيمة، يتم ضبطها تلقائيًا على doNotAutoInstall. يتم تثبيت أي تطبيق تلقائيًا بغض النظر عن نافذة الصيانة المحددة.
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
أولوية التثبيت، بالتنسيق عدد صحيح غير موقَّع كلما كان الرقم أقل، أعطى أولوية أعلى. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
الحد الأدنى لإصدار التطبيق. إذا تم تثبيت إصدار أقدم من التطبيق، سيتم تحديثه تلقائيًا وفقًا لقيود التثبيت التلقائي، بدلاً من انتظار التحديث التلقائي العادي. يمكنك ضبط حد أدنى لرمز الإصدار لـ 20 تطبيقًا كحد أقصى لكل جهاز. | |
policy.productPolicy[].autoUpdateMode |
string |
وضع التحديث التلقائي للمنتج. عند استخدام سياسة autoUpdateMode ، تكون الأولوية دائمًا على اختيار المستخدم. لذلك عندما يُجري المستخدم تغييرات على إعدادات الجهاز يدويًا، يتم تجاهل هذه التغييرات.
في ما يلي القيم المقبولة:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
إعداد عنوان URL للمصادقة في تطبيق المصادقة الخاص بموفِّر هوية يساعد ذلك في تشغيل تطبيق المصادقة لموفّر الهوية أثناء المصادقة التي تتم في تطبيق خاص باستخدام WebView لنظام التشغيل Android. يجب أن يكون تطبيق المصادقة المعالِج التلقائي لعنوان URL للمصادقة على الجهاز. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
عنوان URL للمصادقة. | |
policy.productPolicy[].managedConfiguration |
nested object |
الإعداد المُدار للمنتج. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
يحتوي على رقم تعريف الملف الشخصي للإعدادات المُدارة ومجموعة متغيّرات الضبط (إن وُجدت) المحدّدة للمستخدم. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
رقم تعريف إعدادات الضبط المُدار | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
يشير ذلك المصطلح إلى مجموعة المتغيّر المنسوبة إلى المستخدم. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
سلسلة العنصر النائب التي تحدّدها إدارة الخدمات الجوّالة للمؤسسات | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
قيمة العنصر النائب الخاصة بالمستخدم. | |
policy.productPolicy[].managedConfiguration.kind |
string |
تمّت إزالة هذا العمود. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
مجموعة الخصائص المُدارة لهذه الإعدادات. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
تمثّل هذه السمة المفتاح الفريد الذي يعرّف الموقع. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
القيمة المنطقية: لن تظهر هذه القيمة إلا إذا كان نوع السمة هو bool. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
حزمة المواقع المُدارة: لن تتوفّر هذه الحزمة إلا إذا كان نوع الموقع حزمة. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
قائمة المواقع المُدارة | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
قائمة حِزم المواقع الإلكترونية: لن تتوفّر هذه القائمة إلا إذا كان نوع السمة هو package_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
قائمة المواقع المُدارة. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
قيمة العدد الصحيح - لن تكون موجودة إلا إذا كان نوع الخاصية عددًا صحيحًا. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
قيمة السلسلة: لن تظهر هذه القيمة إلا إذا كان نوع السمة سلسلة أو خيار أو مخفيًا. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
قائمة قيم السلسلة - لن تكون موجودة إلا إذا كان نوع الخاصية محددًا. | |
policy.productPolicy[].managedConfiguration.productId |
string |
رقم تعريف المنتج الذي تخصّه الإعدادات المُدارة، مثلاً "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
معرّف المنتج. مثلاً: "app:com.google.android.gm" |
|
policy.productPolicy[].trackIds[] |
list |
يمنح هذا الجهاز إذن الوصول إلى قنوات الإصدار المحدود للمنتجات المحدّدة من خلال trackIds . يمكن الحصول على قائمة مسارات الإصدار لمنتج معيّن من خلال استدعاء Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
تمّ الإيقاف. استخدِم trackIds بدلاً من ذلك. |
|
product |
string |
اسم المنتج للجهاز. مصدر هذه المعلومات هو android.os.Build.PRODUCT . |
|
report |
nested object |
تم تعديل تقرير الجهاز لتضمين أحدث حالات التطبيقات. | |
report.appState[] |
list |
قائمة بحالات التطبيق التي تحدّدها التطبيقات المُدارة على الجهاز يحدِّد مطوّرو التطبيقات حالات التطبيق. سيكون هذا الحقل متوفّرًا دائمًا. | |
report.appState[].keyedAppState[] |
list |
قائمة بحالات التطبيق الأساسية سيكون هذا الحقل متوفّرًا دائمًا. | |
report.appState[].keyedAppState[].data |
string |
حقل إضافي مخصّص للبيانات التي يمكن للآلة قراءتها. على سبيل المثال، رقم أو عنصر JSON. لمنع هجمات XSS، ننصحك بإزالة أي علامات HTML من البيانات قبل عرضها. | |
report.appState[].keyedAppState[].key |
string |
مفتاح يشير إلى ما يوفّره التطبيق ويحدِّد مطوِّر التطبيق محتوى المفتاح. لمنع استخدام أداة XSS، ننصح بإزالة أي رمز HTML من المفتاح قبل عرضه. سيكون هذا الحقل متوفّرًا دائمًا. | |
report.appState[].keyedAppState[].message |
string |
رسالة بتنسيق حر يمكن لشخص عادي قراءتها وتصف حالة التطبيق رسالة خطأ مثلاً. لمنع هجمات XSS، ننصحك بإزالة أي رمز HTML من الرسالة قبل عرضها. | |
report.appState[].keyedAppState[].severity |
string |
خطورة حالة التطبيق سيظهر هذا الحقل دائمًا.
في ما يلي القيم المقبولة:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
الطابع الزمني للوقت الذي يضبط فيه التطبيق الحالة بالمللي ثانية منذ تاريخ بدء حساب الفترة سيكون هذا الحقل متوفّرًا دائمًا. | |
report.appState[].packageName |
string |
اسم حزمة التطبيق. سيظهر هذا الحقل دائمًا. | |
report.lastUpdatedTimestampMillis |
long |
الطابع الزمني لآخر تعديل بالتقرير بالمللي ثانية منذ تاريخ بدء حساب الفترة سيكون هذا الحقل متوفّرًا دائمًا. | |
retailBrand |
string |
العلامة التجارية للبيع بالتجزئة للجهاز، في حال ضبطها. الاطّلاع على android.os.Build.BRAND |
|
sdkVersion |
integer |
إصدار التوافق مع واجهة برمجة التطبيقات |
الطُرق
- forceReportUpload
- يتم تحميل تقرير يحتوي على أي تغييرات في حالات التطبيق على الجهاز منذ تم إنشاء آخر تقرير. يمكنك استدعاء هذه الطريقة بما يصل إلى 3 مرات كل 24 ساعة على جهاز معيّن.
- الحصول
- استرداد تفاصيل جهاز.
- getState
- يسترد ما إذا تم تفعيل إمكانية وصول الجهاز إلى خدمات Google أو غير مفعّل. لا تسري حالة الجهاز إلا في حال فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على نظام التشغيل Android. الأجهزة في وحدة تحكُّم المشرف في Google. وبخلاف ذلك، يتم تجاهل حالة الجهاز والسماح لجميع الأجهزة بالوصول إلى البيانات. بخدمات Google. لا تتوفّر هذه الميزة إلا للمستخدمين الذين تديرها Google.
- list
- استرداد أرقام تعريف جميع أجهزة المستخدم
- setState
- يضبط ما إذا كان سيتم تفعيل إمكانية وصول الجهاز إلى خدمات Google أو إيقافها. لا تسري حالة الجهاز إلا إذا كان فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android مفعَّلاً في "وحدة تحكّم المشرف في Google". بخلاف ذلك، يتم تجاهل حالة الجهاز ويُسمح لجميع الأجهزة بالوصول إلى خدمات Google. ولا تتوفّر هذه الميزة إلا للمستخدمين الخاضعين لإدارة Google.
- تعديل
- تعديل سياسة الجهاز
لضمان فرض السياسة بشكل صحيح، عليك منع الحسابات غير المُدارة من الوصول إلى Google Play من خلال ضبط القيمةallowed_accounts
في الإعدادات المُدارة لحزمة Google Play. راجِع مقالة فرض قيود على الحسابات في Google Play.