للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.
تمثيلات الموارد
يمثل مورد الأجهزة جهازًا جوّالاً تتم إدارته من خلال إدارة الخدمات الجوّالة للمؤسسات (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 }
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
androidId |
string |
رقم تعريف "خدمات Google Play" لنظام التشغيل Android للجهاز الذي تم ترميزه كسلسلة سداسية عشرية صغيرة. مثلاً: "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 |
يحدد مدى تحكم خدمة "إدارة الخدمات الجوّالة للمؤسسات" على "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" على تفعيل التحديثات التلقائية فقط عندما يكون الجهاز متصلاً بشبكة wifi. القيم المقبولة هي:
|
|
policy.deviceReportPolicy |
string |
يمكنك اختيار ما إذا كان الجهاز يبلّغ عن حالات التطبيق في "إدارة الخدمات الجوّالة للمؤسسات". القيمة التلقائية هي "deviceReportEnabledd".
القيم المقبولة هي:
|
|
policy.maintenanceWindow |
nested object |
نافذة الصيانة التي تحدِّد الوقت الذي يجب فيه تحديث التطبيقات التي تعمل في المقدّمة | |
policy.maintenanceWindow.durationMs |
long |
مدة فترة الصيانة، بالمللي ثانية. ويجب أن تتراوح المدة بين 30 دقيقة و24 ساعة (ضمنًا). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
وقت بدء نافذة الصيانة، بالمللي ثانية بعد منتصف الليل على الجهاز يمكن أن تمتد النوافذ في منتصف الليل. | |
policy.productAvailabilityPolicy |
string |
تشير هذه السمة إلى مدى التوفّر الممنوح للجهاز في المنتجات المحدّدة. تمنح الخيار "الكل" الجهاز الإذن بالوصول إلى جميع المنتجات، بغض النظر عن حالة الموافقة. لا يؤدي اختيار "الكل" إلى تفعيل الرؤية التلقائية للمقاطع الصوتية "ألفا" أو "التجريبية". تمنح "القائمة البيضاء" الجهاز إمكانية الوصول إلى المنتجات المحددة في 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 |
سلسلة العنصر النائب المحددة من خلال "إدارة الخدمات الجوّالة للمؤسسات". | |
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 |
قائمة حزم المواقع - لن تظهر هذه إلا إذا كان نوع الموقع هو bundle_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 مفعَّلاً أو غير مفعَّل. لا تسري حالة الجهاز إلا إذا تم تفعيل فرض سياسات إدارة الخدمات الجوّالة للمؤسسات على أجهزة Android في "وحدة تحكّم المشرف في Google". وبخلاف ذلك، يتم تجاهل حالة الجهاز ويتم السماح لجميع الأجهزة بالوصول إلى خدمات Google. وهذا الخيار متاح فقط للمستخدمين الذين تديرهم Google.
- list
- استرداد أرقام تعريف جميع أجهزة المستخدم.
- setState
- يحدِّد ما إذا كان وصول الجهاز إلى خدمات Google مفعَّلاً أو غير مفعَّل. لا تسري حالة الجهاز إلا إذا تم تفعيل فرض سياسات إدارة الخدمات الجوّالة للمؤسسات على أجهزة Android في "وحدة تحكّم المشرف في Google". وبخلاف ذلك، يتم تجاهل حالة الجهاز ويتم السماح لجميع الأجهزة بالوصول إلى خدمات Google. وهذا الخيار متاح فقط للمستخدمين الذين تديرهم Google.
- تعديل
- تحديث سياسة الجهاز
لضمان تطبيق السياسة على النحو الصحيح، يجب منع الحسابات غير المُدارة من الوصول إلى Google Play من خلال ضبطallowed_accounts
في الإعدادات المُدارة لحزمة Google Play. راجِع تقييد الحسابات في Google Play.