للحصول على قائمة بالأساليب لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.
تمثيلات الموارد
يمثّل مورد "الأجهزة" جهازًا جوّالاً تديره خدمة إدارة الخدمات الجوّالة للمؤسسات (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" وفقًا لـ logs/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 أي تأثير.
القيم المقبولة هي:
|
|
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" الجهاز إذن الوصول إلى جميع المنتجات، بصرف النظر عن حالة الموافقة. لا يؤدي الخيار "الكل" إلى تفعيل مستوى الرؤية التلقائي للقنوات الاختبارية أو القنوات التجريبية. تمنح "القائمة المسموح بها" الجهاز إذن الوصول إلى المنتجات المحدّدة في 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 |
قائمة حِزم المواقع: لن تظهر هذه السمة إلا إذا كان نوع الموقع هو 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 مفعَّلاً أو غير مفعَّل. لا تسري حالة الجهاز إلا إذا كان فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android مفعَّلاً في "وحدة تحكّم المشرف في Google". بخلاف ذلك، يتم تجاهل حالة الجهاز ويُسمح لجميع الأجهزة بالوصول إلى خدمات Google. لا تتوفّر هذه الميزة إلا للمستخدمين الذين تديرها Google.
- list
- استرداد أرقام تعريف جميع أجهزة المستخدم
- setState
- يضبط ما إذا كان سيتم تفعيل إمكانية وصول الجهاز إلى خدمات Google أو إيقافها. لا تسري حالة الجهاز إلا إذا كان فرض سياسات إدارة الخدمات الجوّالة للمؤسسات (EMM) على أجهزة Android مفعَّلاً في "وحدة تحكّم المشرف في Google". بخلاف ذلك، يتم تجاهل حالة الجهاز ويُسمح لجميع الأجهزة بالوصول إلى خدمات Google. لا تتوفّر هذه الميزة إلا للمستخدمين الذين تديرها Google.
- تعديل
- تعديل سياسة الجهاز
لضمان فرض السياسة بشكل صحيح، عليك منع الحسابات غير المُدارة من الوصول إلى Google Play من خلال ضبط القيمةallowed_accounts
في الإعدادات المُدارة لحزمة Google Play. راجِع مقالة فرض قيود على الحسابات في Google Play.