للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
يمثل مورد الأجهزة جهازًا جوّالاً تتم إدارته بواسطة إدارة الخدمات الجوّالة للمؤسسات (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 }, "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" يسمح لمستخدم الجهاز بضبط سياسة تحديث التطبيقات. "دائمًا" لتفعيل التحديثات التلقائية. "أبدًا" لإيقاف التحديثات التلقائية. "شبكة wifi فقط" لتفعيل التحديثات التلقائية فقط عندما يكون الجهاز متصلاً بشبكة Wi-Fi. في ما يلي القيم المقبولة:
|
|
policy.deviceReportPolicy |
string |
يمكنك اختيار ما إذا كان الجهاز سيرسل حالة التطبيق إلى إدارة الخدمات الجوّالة للمؤسسات (EMM). القيمة التلقائية هي "deviceReportDisabled".
في ما يلي القيم المقبولة:
|
|
policy.maintenanceWindow |
nested object |
يجب تحديث نافذة الصيانة التي تحدِّد وقت التطبيقات التي تعمل في المقدّمة. | |
policy.maintenanceWindow.durationMs |
long |
مدة فترة الصيانة بالمللي ثانية. يجب أن تكون المدة بين 30 دقيقة و24 ساعة (ضمنًا). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
وقت بدء نافذة الصيانة بالملي ثانية بعد منتصف الليل على الجهاز وقد تمتد النوافذ في منتصف الليل. | |
policy.productAvailabilityPolicy |
string |
تشير هذه السمة إلى مدى التوفّر الممنوح للجهاز في ما يتعلّق بالمنتجات المحدّدة. "الكل" للجهاز حق الوصول إلى جميع المنتجات، بغض النظر عن حالة الموافقة. "الكل" لا يؤدي إلى تفعيل الرؤية التلقائية لـ "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 لمصادقة تطبيق المصادقة لموفِّر الهوية يساعد ذلك في تشغيل تطبيق المصادقة لموفِّر الهوية أثناء إجراء عملية المصادقة في تطبيق خاص باستخدام Android WebView. يجب أن يكون تطبيق Authenticator هو المعالج التلقائي لعنوان 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 |
سلسلة العنصر النائب؛ التي تحددها إدارة الخدمات الجوّالة للمؤسسات (EMM). | |
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 |
القيمة المنطقية - لن تكون موجودة إلا إذا كان نوع الخاصية منطقيًا. | |
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.