- المورد: الجهاز
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- الشاشة
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- درجة الفداحة
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- الطُرق
المرجع: الجهاز
هو جهاز تملكه مؤسسة. ما لم يُذكر خلاف ذلك، جميع الحقول للقراءة فقط ولا يمكن تعديلها بواسطة enterprises.devices.patch
.
تمثيل JSON |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم الجهاز بالتنسيق |
userName |
تمثّل هذه السمة اسم المورد للمستخدم الذي يملك هذا الجهاز في النموذج |
managementMode |
نوع وضع الإدارة المستخدَم في تطبيق Android Device Policy على الجهاز. يؤثر ذلك في إعدادات السياسة المتوافقة. |
state |
الحالة التي سيتم تطبيقها على الجهاز. يمكن تعديل هذا الحقل من خلال طلب تصحيح. يُرجى العِلم أنّه عند طلب البيانات |
appliedState |
الحالة السارية على الجهاز حاليًا. |
policyCompliant |
ما إذا كان الجهاز متوافقًا مع السياسة |
nonComplianceDetails[] |
تفاصيل حول إعدادات السياسة التي لا يتوافق الجهاز معها. |
enrollmentTime |
وقت تسجيل الجهاز طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
lastStatusReportTime |
آخر مرة أرسل فيها الجهاز تقرير حالة. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
lastPolicyComplianceReportTime |
تمّ الإيقاف. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
lastPolicySyncTime |
تاريخ آخر مرة جلب فيها الجهاز سياسته. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
policyName |
تمثّل هذه السمة اسم السياسة المطبَّقة على الجهاز بالتنسيق |
appliedPolicyName |
اسم السياسة المطبقة حاليًا على الجهاز. |
appliedPolicyVersion |
إصدار السياسة المطبَّق حاليًا على الجهاز |
apiLevel |
مستوى واجهة برمجة التطبيقات لإصدار نظام Android الأساسي الذي يعمل على الجهاز |
enrollmentTokenData |
إذا كان الجهاز مسجلاً باستخدام رمز مميَّز للتسجيل مع بيانات إضافية، سيحتوي هذا الحقل على تلك البيانات. |
enrollmentTokenName |
إذا كان الجهاز مسجَّلاً باستخدام رمز مميَّز للتسجيل، يحتوي هذا الحقل على اسم الرمز المميّز. |
disabledReason |
إذا كانت حالة الجهاز هي |
softwareInfo |
معلومات تفصيلية حول برنامج الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
hardwareInfo |
معلومات تفصيلية حول مكونات الجهاز |
displays[] |
معلومات تفصيلية حول الشاشات على الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
applicationReports[] |
تقارير عن التطبيقات المثبّتة على الجهاز ولا تتوفّر هذه المعلومات إلا عندما تكون السياسة |
previousDeviceNames[] |
إذا تم تسجيل الجهاز الفعلي نفسه عدة مرات، سيحتوي هذا الحقل على أسماء الأجهزة السابقة. يُستخدم الرقم التسلسلي كمعرّف فريد لتحديد ما إذا تم تسجيل الجهاز نفسه في السابق. تظهر الأسماء بترتيب زمني. |
networkInfo |
معلومات شبكة الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
memoryInfo |
معلومات الذاكرة: تحتوي على معلومات عن ذاكرة الجهاز ومساحة التخزين. |
memoryEvents[] |
الأحداث ذات الصلة بقياسات الذاكرة وسعة التخزين بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت سياسة يتم الاحتفاظ بالأحداث لفترة زمنية معيّنة ويتم حذف الأحداث القديمة. |
powerManagementEvents[] |
أحداث إدارة الطاقة على الجهاز بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
hardwareStatusSamples[] |
نماذج لحالة الأجهزة بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
deviceSettings |
معلومات إعدادات الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت سياسة |
user |
المستخدم الذي يملك الجهاز. |
systemProperties |
خريطة تعرض اسم خصائص النظام المحدّدة وقيمتها المرتبطة بالجهاز لا تتوفّر هذه المعلومات إلا إذا كانت سياسة عنصر يحتوي على قائمة بأزواج |
securityPosture |
قيمة الوضع الأمني للجهاز التي تعكس مدى أمان الجهاز. |
ownership |
ملكية الجهاز المُدار |
commonCriteriaModeInfo |
معلومات عن "وضع المعايير المشتركة"، وهي معايير الأمان المحدّدة في المعايير المشتركة لتقييم أمان تكنولوجيا المعلومات (CC). لا تتوفّر هذه المعلومات إلا إذا كان |
appliedPasswordPolicies[] |
متطلبات كلمة المرور المطبقة حاليًا على الجهاز.
|
dpcMigrationInfo |
النتائج فقط. معلومات تتعلّق بما إذا كان قد تم نقل هذا الجهاز من وحدة تحكّم أخرى بسياسة الجهاز (DPC) |
DeviceState
يشير إلى الحالات التي يمكن تطبيقها على أحد الأجهزة.
عمليات التعداد | |
---|---|
DEVICE_STATE_UNSPECIFIED |
هذه القيمة غير مسموح بها. |
ACTIVE |
الجهاز نشط. |
DISABLED |
تم إيقاف الجهاز. |
DELETED |
تم حذف الجهاز. ولا يتم عرض هذه الحالة مطلقًا من خلال طلب بيانات من واجهة برمجة التطبيقات، ولكن يتم استخدامها في تقرير الحالة النهائي عندما يقر الجهاز بالحذف. في حال تم حذف الجهاز من خلال طلب بيانات من واجهة برمجة التطبيقات، سيتم نشر هذه الحالة في خدمة Pub/Sub. إذا حذف المستخدم الملف الشخصي للعمل أو أعاد ضبط الجهاز، ستظل حالة الجهاز غير معروفة للخادم. |
PROVISIONING |
تتم إدارة الجهاز. تظل الأجهزة المسجَّلة حديثًا في هذه الحالة إلى أن يتم تطبيق سياسة عليها. |
LOST |
الجهاز مفقود. ولا يمكن تنفيذ هذه الحالة إلا على الأجهزة التي تملكها المؤسسة. |
PREPARING_FOR_MIGRATION |
يتم الآن الاستعداد لنقل البيانات إلى Android Management API على الجهاز. ليس عليك اتّخاذ أي إجراء إضافي لمواصلة عملية نقل البيانات. |
DEACTIVATED_BY_DEVICE_FINANCE |
هذا جهاز مموَّل "تم قفله" من قبل وكيل التمويل يعني هذا أنّه تم تطبيق إعدادات معيّنة للسياسة تحدّ من وظائف الجهاز إلى أن يتم "فتح قفل" الجهاز. من قبل وكيل التمويل سيستمر الجهاز في تطبيق إعدادات السياسة باستثناء تلك التي تجاوزها وكيل التمويل. عندما يكون الجهاز "مقفلاً"، يتم الإبلاغ عن حالته في appliedState على أنّها DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
توفِّر هذه السياسة تفاصيل حول عدم الامتثال لأحد إعدادات السياسة.
تمثيل JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
الحقول | |
---|---|
settingName |
اسم إعداد السياسة. هذا هو اسم حقل JSON لحقل |
nonComplianceReason |
سبب عدم توافق الجهاز مع الإعداد. |
packageName |
اسم الحزمة الذي يشير إلى التطبيق الذي لا يمتثل للسياسات، إذا كان ذلك منطبقًا |
fieldPath |
بالنسبة إلى الإعدادات التي تحتوي على حقول متداخلة، إذا كان حقل متداخل معين غير متوافق، فإن هذا يحدد المسار الكامل إلى الحقل المسيء. يتم تنسيق المسار بالطريقة نفسها التي ستتم بها الإشارة إلى حقل JSON للسياسة في JavaScript، وهي: 1) بالنسبة إلى الحقول التي تكتبها عناصر، يكون اسم الحقل متبوعًا بنقطة ثم باسم حقل فرعي. 2) بالنسبة إلى الحقول التي تندرج ضمن مصفوفة، يتبع اسم الحقل فهرس الصفيف الموضوع بين قوسين. على سبيل المثال، للإشارة إلى مشكلة في الحقل |
currentValue |
إذا تعذّر تطبيق إعداد السياسة، يتم ضبط القيمة الحالية للإعداد على الجهاز. |
installationFailureReason |
في حال ضبط |
specificNonComplianceReason |
السبب المحدَّد للسياسة لعدم امتثال الجهاز للإعداد. |
specificNonComplianceContext |
سياق إضافي حول |
InstallationFailureReason
الأسباب المحتملة لتعذُّر تثبيت التطبيق.
عمليات التعداد | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
هذه القيمة غير مسموح بها. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
هناك حالة غير معروفة تمنع تثبيت التطبيق. قد لا تتوفّر مساحة تخزين كافية على الجهاز، أو أنّ الاتصال بشبكة الجهاز غير موثوق به، أو أنّ عملية التثبيت تستغرق وقتًا أطول من المتوقّع. ستتم إعادة محاولة التثبيت تلقائيًا. |
IN_PROGRESS |
لا تزال عملية التثبيت قيد التقدم. |
NOT_FOUND |
لم يتم العثور على التطبيق في Play. |
NOT_COMPATIBLE_WITH_DEVICE |
التطبيق غير متوافق مع الجهاز. |
NOT_APPROVED |
لم يوافق المشرف على التطبيق. |
PERMISSIONS_NOT_ACCEPTED |
يمتلك التطبيق أذونات جديدة لم يقبلها المشرف. |
NOT_AVAILABLE_IN_COUNTRY |
التطبيق غير متاح في بلد المستخدم. |
NO_LICENSES_REMAINING |
ليست هناك تراخيص متاحة لتعيينها للمستخدم. |
NOT_ENROLLED |
لم تعُد المؤسسة مسجَّلة في "Google Play للأعمال" أو لم يقبل المشرف أحدث بنود خدمة "Google Play للأعمال". |
USER_INVALID |
لم يعد المستخدم صالحًا. ربما تم حذف المستخدم أو إيقافه. |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
أدّى خطأ في الشبكة على جهاز المستخدم إلى منع التثبيت من النجاح. ويحدث ذلك عادةً عندما يكون اتصال الإنترنت للجهاز ضعيفًا أو غير متاح أو عند وجود مشكلة في إعدادات الشبكة. يُرجى التأكّد من أنّ الجهاز متصل بالإنترنت بشكلٍ كامل على شبكة تتوافق مع |
INSUFFICIENT_STORAGE |
لا تتوفّر مساحة تخزين كافية على جهاز المستخدم لتثبيت التطبيق. ويمكن حل هذه المشكلة من خلال إخلاء مساحة تخزين على الجهاز. سيتم تلقائيًا استئناف عملية تثبيت التطبيق أو تحديثه بعد توفُّر مساحة تخزين كافية على الجهاز. |
SpecificNonComplianceReason
مزيد من التفاصيل عن السبب المحتمل لعدم توافق الجهاز مع إعداد السياسة. ويمكن إضافة قيم جديدة إلى التعداد في المستقبل.
عمليات التعداد | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
لم يتم تحديد سبب عدم الامتثال. لم يتم ضبط الحقول في . |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
يحتاج المستخدم إلى تأكيد بيانات الاعتماد من خلال إدخال قفل الشاشة. لم يتم ضبط الحقول في . تم ضبط على . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
انتهت صلاحية كلمة مرور الجهاز أو الملف الشخصي. تم ضبط . تم ضبط على . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
كلمة مرور الجهاز لا تستوفي متطلبات كلمة المرور. تم ضبط . تم ضبط على . |
ONC_WIFI_INVALID_VALUE |
هناك قيمة غير صحيحة في إعداد Wi-Fi لـ ONC. يحدّد قيمة الحقل غير الصحيحة. تم ضبط . تم ضبط على . |
ONC_WIFI_API_LEVEL |
إعداد ONC Wi-Fi غير متوافق مع مستوى واجهة برمجة التطبيقات لإصدار Android الذي يتم تشغيله على الجهاز. يحدّد قيمة الحقل غير المتاحة. تم ضبط . تم ضبط على . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
لا تحتوي شبكة Wi-Fi الخاصة بالمؤسسة على شهادة CA الجذر أو اسم النطاق. تم ضبط على . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
على المستخدم إزالة شبكة Wi-Fi التي تم ضبطها يدويًا. ولا يسري ذلك إلا على الملفات الشخصية للعمل على الأجهزة الشخصية. تم ضبط على . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
لا يتوافق الاسم المستعار لزوج المفاتيح المحدَّد عبر الحقل ClientCertKeyPairAlias في مع مفتاح حالي مثبَّت على الجهاز. تم ضبط على . |
SpecificNonComplianceContext
سياق إضافي حول SpecificNonComplianceReason
تمثيل JSON |
---|
{ "oncWifiContext": { object ( |
الحقول | |
---|---|
oncWifiContext |
سياق إضافي لعدم الامتثال في ما يتعلّق بإعداد شبكة Wi-Fi. الاطّلاع على |
passwordPoliciesContext |
سياق إضافي لعدم الامتثال في ما يتعلّق بسياسات كلمات المرور يمكنك الاطّلاع على |
OncWifiContext
سياق إضافي لعدم الامتثال في ما يتعلّق بإعداد شبكة Wi-Fi.
تمثيل JSON |
---|
{ "wifiGuid": string } |
الحقول | |
---|---|
wifiGuid |
المعرِّف الفريد العالمي (GUID) لضبط شبكة Wi-Fi غير المتوافقة. |
PasswordPoliciesContext
سياق إضافي لعدم الامتثال في ما يتعلّق بسياسات كلمات المرور
تمثيل JSON |
---|
{
"passwordPolicyScope": enum ( |
الحقول | |
---|---|
passwordPolicyScope |
نطاق كلمة المرور غير المتوافقة. |
SoftwareInfo
معلومات حول برامج الجهاز
تمثيل JSON |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
الحقول | |
---|---|
androidVersion |
سلسلة إصدار Android المرئية للمستخدم مثلاً: |
androidDevicePolicyVersionCode |
رمز إصدار تطبيق Android Device Policy. |
androidDevicePolicyVersionName |
إصدار تطبيق Android Device Policy كما هو موضّح للمستخدم |
androidBuildNumber |
سلسلة رقم تعريف إصدار Android الموجَّهة لعرضها للمستخدم مثلاً: |
deviceKernelVersion |
إصدار النواة، على سبيل المثال، |
bootloaderVersion |
رقم إصدار برنامج إقلاع النظام، مثل |
androidBuildTime |
وقت الإنشاء: طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
securityPatchLevel |
مستوى رمز تصحيح الأمان، على سبيل المثال |
primaryLanguageCode |
رمز لغة IETF BCP 47 للغة الأساسية على الجهاز. |
deviceBuildSignature |
تجزئة SHA-256 لـ |
systemUpdateInfo |
معلومات حول تحديث محتمل في انتظار المراجعة للنظام |
SystemUpdateInfo
معلومات حول تحديث محتمل في انتظار المراجعة للنظام
تمثيل JSON |
---|
{
"updateStatus": enum ( |
الحقول | |
---|---|
updateStatus |
حالة التحديث: ما إذا كان يتوفّر تحديث ونوعه. |
updateReceivedTime |
الوقت الذي توفّر فيه التحديث لأول مرة. تشير القيمة "صفر" إلى عدم تعيين هذا الحقل. يتم ضبط هذا الحقل فقط في حال توفُّر تحديث (أي أنّ القيمة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
UpdateStatus
حالة التحديث: ما إذا كان يتوفّر تحديث ونوعه.
عمليات التعداد | |
---|---|
UPDATE_STATUS_UNKNOWN |
ما إذا كان هناك تحديث في انتظار التثبيت للنظام أم لا. ويحدث ذلك مثلاً إذا كان مستوى واجهة برمجة التطبيقات للجهاز أقل من 26 أو إذا كان إصدار تطبيق Android Device Policy قديمًا. |
UP_TO_DATE |
لا يتوفّر تحديث للنظام في انتظار التثبيت على الجهاز. |
UNKNOWN_UPDATE_AVAILABLE |
يتوفّر تحديث في انتظار التثبيت للنظام، ولكن نوعه غير معروف. |
SECURITY_UPDATE_AVAILABLE |
يتوفّر تحديث أمان في انتظار التثبيت. |
OS_UPDATE_AVAILABLE |
يتوفّر تحديث لنظام التشغيل في انتظار التثبيت. |
HardwareInfo
معلومات حول معدّات الجهاز لا تتوفّر الحقول المرتبطة بالحد الأدنى لدرجة الحرارة إلا في حال ضبط hardwareStatusEnabled
في سياسة الجهاز.
تمثيل JSON |
---|
{ "brand": string, "hardware": string, "deviceBasebandVersion": string, "manufacturer": string, "serialNumber": string, "model": string, "batteryShutdownTemperatures": [ number ], "batteryThrottlingTemperatures": [ number ], "cpuShutdownTemperatures": [ number ], "cpuThrottlingTemperatures": [ number ], "gpuShutdownTemperatures": [ number ], "gpuThrottlingTemperatures": [ number ], "skinShutdownTemperatures": [ number ], "skinThrottlingTemperatures": [ number ], "enterpriseSpecificId": string } |
الحقول | |
---|---|
brand |
العلامة التجارية للجهاز مثلاً: |
hardware |
اسم الجهاز. مثلاً: |
deviceBasebandVersion |
إصدار النطاق الأساسي مثلاً: |
manufacturer |
الشركة المصنِّعة مثلاً: |
serialNumber |
الرقم التسلسلي للجهاز |
model |
طراز الجهاز. مثلاً: |
batteryShutdownTemperatures[] |
الحد الأدنى لدرجة حرارة إيقاف البطارية بالدرجة المئوية لكل بطارية على الجهاز |
batteryThrottlingTemperatures[] |
الحد الأدنى لدرجة حرارة تقييد البطارية بالدرجة المئوية لكل بطارية على الجهاز |
cpuShutdownTemperatures[] |
الحد الأدنى لدرجة حرارة إيقاف وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية (CPU) على الجهاز |
cpuThrottlingTemperatures[] |
الحد الأدنى لدرجة حرارة تقييد وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية (CPU) على الجهاز |
gpuShutdownTemperatures[] |
الحد الأدنى لدرجة حرارة إيقاف وحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز |
gpuThrottlingTemperatures[] |
الحد الأدنى لدرجة حرارة تقييد وحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز |
skinShutdownTemperatures[] |
الحد الأدنى لدرجة حرارة الجهاز عند إيقاف تشغيله بالدرجة المئوية |
skinThrottlingTemperatures[] |
الحد الأدنى لدرجة حرارة الجهاز التي تقيِّد درجة الحرارة بالدرجة المئوية |
enterpriseSpecificId |
النتائج فقط. رقم تعريف يُحدِّد بشكلٍ فريد جهازًا مملوكًا شخصيًا في مؤسسة معيَّنة. يظل رقم التعريف هذا متوفّرًا على الجهاز نفسه عند تسجيله لدى المؤسسة نفسها، وذلك في جميع عمليات الإعداد وحتى عمليات إعادة الضبط على الإعدادات الأصلية. يتوفّر هذا المعرّف على الأجهزة الشخصية التي تتضمن ملفًا شخصيًا للعمل على الأجهزة التي تعمل بنظام التشغيل Android 12 والإصدارات الأحدث. |
الشبكة الإعلانية
معلومات عرض الجهاز
تمثيل JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
الحقول | |
---|---|
name |
اسم الشاشة |
displayId |
معرّف العرض الفريد |
refreshRate |
معدّل إعادة تحميل الشاشة باللقطات في الثانية |
state |
حالة الشاشة |
width |
عرض العرض بالبكسل |
height |
ارتفاع العرض بالبكسل |
density |
يتم التعبير عن كثافة العرض بنقاط لكل بوصة. |
DisplayState
حالة الشاشة
عمليات التعداد | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
هذه القيمة غير مسموح بها. |
OFF |
الشاشة غير مفعَّلة. |
ON |
الشاشة قيد التشغيل. |
DOZE |
الشاشة تغفل في حالة الطاقة المنخفضة |
SUSPENDED |
تتوقّف الشاشة عن النوم في حالة تعليق الطاقة منخفضة. |
ApplicationReport
المعلومات التي تم الإبلاغ عنها حول تطبيق مثبَّت
تمثيل JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
الحقول | |
---|---|
packageName |
اسم حزمة التطبيق |
versionName |
إصدار التطبيق كما هو ظاهر للمستخدم. |
versionCode |
رمز إصدار التطبيق، والذي يمكن استخدامه لتحديد ما إذا كان أحد الإصدارات أحدث من إصدار آخر |
events[] |
قائمة بأحداث التطبيقات التي حدثت خلال آخر 30 ساعة. |
displayName |
الاسم المعروض للتطبيق. |
packageSha256Hash |
تجزئة SHA-256 لملف APK للتطبيق، والتي يمكن استخدامها للتحقق من عدم تعديل التطبيق. يتم تمثيل كل بايت من قيمة التجزئة كعدد سداسي عشري من رقمين. |
signingKeyCertFingerprints[] |
تجزئة SHA-1 لكل |
installerPackageName |
اسم حزمة التطبيق الذي ثبَّت هذا التطبيق |
applicationSource |
مصدر الحزمة. |
state |
حالة التطبيق |
keyedAppStates[] |
قائمة بحالات التطبيق الأساسية التي أبلغ عنها التطبيق |
userFacingType |
ما إذا كان التطبيق موجّهًا للمستخدمين |
ApplicationEvent
حدث ذو صلة بالتطبيق.
تمثيل JSON |
---|
{
"eventType": enum ( |
الحقول | |
---|---|
eventType |
نوع حدث التطبيق. |
createTime |
وقت إنشاء الحدث طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
ApplicationEventType
نوع من الأحداث ذات الصلة بالتطبيق
عمليات التعداد | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
هذه القيمة غير مسموح بها. |
INSTALLED |
تم تثبيت التطبيق. |
CHANGED |
تم تغيير التطبيق، على سبيل المثال، تفعيل مكوِّن أو إيقافه. |
DATA_CLEARED |
تم محو بيانات التطبيق. |
REMOVED |
تمت إزالة التطبيق. |
REPLACED |
تم تثبيت إصدار جديد من التطبيق بدلاً من الإصدار القديم. |
RESTARTED |
تمت إعادة تشغيل التطبيق. |
PINNED |
تم تثبيت التطبيق في المقدّمة. |
UNPINNED |
تمت إزالة تثبيت التطبيق. |
ApplicationSource
المصدر الذي قدَّم التطبيق.
عمليات التعداد | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
تم تثبيت التطبيق من مصدر غير محدَّد. |
SYSTEM_APP_FACTORY_VERSION |
هذا تطبيق نظام مأخوذ من صورة المصنع للجهاز. |
SYSTEM_APP_UPDATED_VERSION |
هذا تطبيق نظام مُحدَّث. |
INSTALLED_FROM_PLAY_STORE |
تم تثبيت التطبيق من "متجر Google Play". |
ApplicationState
حالة التثبيت الحالية.
عمليات التعداد | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
حالة التطبيق غير محدّدة |
REMOVED |
تمت إزالة التطبيق من الجهاز. |
INSTALLED |
تم تثبيت التطبيق على الجهاز. |
KeyedAppState
حالة التطبيق الأساسية التي أبلغ عنها التطبيق
تمثيل JSON |
---|
{
"key": string,
"severity": enum ( |
الحقول | |
---|---|
key |
مفتاح حالة التطبيق. يعمل كنقطة مرجعية لما يوفّره التطبيق. على سبيل المثال، عند تقديم ملاحظات بشأن الإعدادات المُدارة، يمكن أن يكون هذا المفتاح هو مفتاح الضبط المُدار. |
severity |
درجة خطورة حالة التطبيق. |
message |
يمكنك اختيار سلسلة رسالة حرة لشرح حالة التطبيق. وإذا تم تفعيل الحالة باستخدام قيمة معيّنة (مثل قيمة إعدادات مُدارة)، يجب تضمينها في الرسالة. |
data |
اختياريًا، قيمة يمكن للجهاز قراءتها بواسطة إدارة الخدمات الجوّالة للمؤسسات (EMM). على سبيل المثال، قيم الإعدادات التي يمكن للمشرف اختيار طلبها في وحدة تحكُّم إدارة الخدمات الجوّالة للمؤسسات (EMM) (مثل "إرسال إشعار إليّ إذا كانت بيانات تحذير البطارية < 10"). |
createTime |
وقت إنشاء حالة التطبيق على الجهاز طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
lastUpdateTime |
الوقت الذي تم فيه تعديل حالة التطبيق مؤخرًا طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
درجة الخطورة
درجة خطورة حالة التطبيق.
عمليات التعداد | |
---|---|
SEVERITY_UNSPECIFIED |
مستوى خطورة غير محدَّد |
INFO |
مستوى خطورة المعلومات. |
ERROR |
مستوى خطورة الخطأ. ويجب عدم ضبط ذلك إلا في حالات الخطأ الحقيقية التي تحتاج المؤسسة الإدارية إلى اتخاذ إجراءات لإصلاحها. |
UserFacingType
ما إذا كان التطبيق موجّهًا للمستخدمين
عمليات التعداد | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
لم يتم تحديد النوع الموجَّه لمستخدمي التطبيق. |
NOT_USER_FACING |
التطبيق لا يستهدف المستخدمين. |
USER_FACING |
التطبيق موجَّه للمستخدمين. |
NetworkInfo
معلومات شبكة الجهاز
تمثيل JSON |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
الحقول | |
---|---|
imei |
رقم IMEI لجهاز GSM. مثلاً: |
meid |
رقم MEID لجهاز CDMA. مثلاً: |
wifiMacAddress |
عنوان Wi-Fi MAC للجهاز. مثلاً: |
networkOperatorName |
الاسم الأبجدي للمشغّل المسجَّل الحالي على سبيل المثال، Vodafone. |
telephonyInfos[] |
توفّر معلومات الاتصال الهاتفي المرتبطة بكل شريحة SIM على الجهاز. لا تتوفّر هذه الميزة إلا على الأجهزة المُدارة بالكامل بدءًا من المستوى 23 من واجهة برمجة تطبيقات Android. |
TelephonyInfo
معلومات الاتصال الهاتفي المرتبطة بشريحة SIM معيّنة على الجهاز لا تتوفّر هذه الميزة إلا على الأجهزة المُدارة بالكامل بدءًا من المستوى 23 من واجهة برمجة تطبيقات Android.
تمثيل JSON |
---|
{ "phoneNumber": string, "carrierName": string } |
الحقول | |
---|---|
phoneNumber |
رقم الهاتف المرتبط بشريحة SIM هذه. |
carrierName |
اسم مشغّل شبكة الجوّال المرتبط بشريحة SIM هذه |
MemoryInfo
معلومات حول ذاكرة الجهاز ومساحة التخزين
تمثيل JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
الحقول | |
---|---|
totalRam |
إجمالي ذاكرة الوصول العشوائي على الجهاز بالبايت. |
totalInternalStorage |
إجمالي مساحة التخزين الداخلية للجهاز بالبايت. |
MemoryEvent
حدث مرتبط بقياسات الذاكرة وسعة التخزين.
للتمييز بين الأحداث الجديدة والقديمة، ننصحك باستخدام الحقل
.createTime
تمثيل JSON |
---|
{
"eventType": enum ( |
الحقول | |
---|---|
eventType |
نوع الحدث. |
createTime |
وقت إنشاء الحدث طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
byteCount |
عدد وحدات البايت الحرة في الوسيط، أو لـ |
MemoryEventType
نوع الفعالية.
عمليات التعداد | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
غير محدد لا تتوفّر أحداث من هذا النوع. |
RAM_MEASURED |
تم قياس المساحة الخالية في ذاكرة الوصول العشوائي. |
INTERNAL_STORAGE_MEASURED |
تم قياس المساحة الخالية في وحدة التخزين الداخلية. |
EXTERNAL_STORAGE_DETECTED |
تم رصد وسيط جديد لمساحة تخزين خارجية. عدد وحدات البايت التي تم الإبلاغ عنها هو إجمالي سعة التخزين. |
EXTERNAL_STORAGE_REMOVED |
تمت إزالة وسيط وحدة تخزين خارجية. عدد وحدات البايت التي تم الإبلاغ عنها هو صفر. |
EXTERNAL_STORAGE_MEASURED |
تم قياس المساحة الخالية في وسيط وحدة تخزين خارجية. |
PowerManagementEvent
حدث لإدارة الطاقة
تمثيل JSON |
---|
{
"eventType": enum ( |
الحقول | |
---|---|
eventType |
نوع الحدث. |
createTime |
وقت إنشاء الحدث طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
batteryLevel |
بالنسبة إلى أحداث |
PowerManagementEventType
نوع الفعالية.
عمليات التعداد | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
غير محدد لا تتوفّر أحداث من هذا النوع. |
BATTERY_LEVEL_COLLECTED |
تم قياس مستوى البطارية. |
POWER_CONNECTED |
بدأ شحن الجهاز. |
POWER_DISCONNECTED |
توقف شحن الجهاز. |
BATTERY_LOW |
دخل الجهاز في وضع الطاقة المنخفضة. |
BATTERY_OKAY |
خرج الجهاز من وضع الطاقة المنخفضة. |
BOOT_COMPLETED |
تم تشغيل الجهاز. |
SHUTDOWN |
تم إيقاف تشغيل الجهاز. |
HardwareStatus
حالة الجهاز. ويمكن أن تتم مقارنة درجات الحرارة بدرجات الحرارة الدنيا المتاحة في hardwareInfo
لتحديد سلامة الأجهزة.
تمثيل JSON |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
الحقول | |
---|---|
createTime |
الوقت الذي تم فيه إجراء القياسات. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
batteryTemperatures[] |
درجات الحرارة الحالية للبطارية بالدرجة المئوية لكل بطارية على الجهاز |
cpuTemperatures[] |
درجات الحرارة الحالية لوحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية (CPU) على الجهاز |
gpuTemperatures[] |
درجات الحرارة الحالية لوحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز |
skinTemperatures[] |
درجات حرارة الجلد الحالية بالدرجة المئوية |
fanSpeeds[] |
تشير هذه السمة إلى سرعة المروحة في عدد المروحة لكل مروحة على الجهاز. تعني المصفوفة الفارغة أنّ النظام لا يتضمّن مراوح أو أنّ سرعة المروحة غير متاحة. |
cpuUsages[] |
استخدامات وحدة المعالجة المركزية (CPU) بالنسبة المئوية لكل وحدة معالجة مركزية (CPU) متاحة على الجهاز معدّل الاستخدام 0 لكل نواة غير متصلة. تشير الصفيفة الفارغة إلى أن استخدام وحدة المعالجة المركزية (CPU) غير متاح في النظام. |
DeviceSettings
معلومات حول إعدادات الجهاز ذات الصلة بالأمان على الجهاز
تمثيل JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
الحقول | |
---|---|
isDeviceSecure |
ما إذا كان الجهاز مؤمَّنًا باستخدام رقم تعريف شخصي أو كلمة مرور |
unknownSourcesEnabled |
ما إذا كان سيتم تفعيل تثبيت التطبيقات من مصادر غير معروفة. |
developmentSettingsEnabled |
ما إذا كان وضع مطوّر البرامج مفعَّلاً على الجهاز أم لا. |
adbEnabled |
ما إذا كان ADB مفعَّلاً على الجهاز. |
isEncrypted |
ما إذا كان سيتم تفعيل تشفير مساحة التخزين |
encryptionStatus |
حالة التشفير من DevicePolicyManager. |
verifyAppsEnabled |
ما إذا كان سيتم فرض التحقّق من خلال "Google Play للحماية" على الجهاز |
EncryptionStatus
حالة التشفير لجهاز.
عمليات التعداد | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
غير محدد يجب ألا يكون هذا النوع من الأجهزة متوفرًا. |
UNSUPPORTED |
التشفير غير متوافق مع الجهاز. |
INACTIVE |
التشفير متاح على الجهاز، ولكنه غير نشط حاليًا. |
ACTIVATING |
التشفير غير نشط في الوقت الحالي، ولكن يتم تفعيله حاليًا. |
ACTIVE |
التشفير نشط. |
ACTIVE_DEFAULT_KEY |
التشفير نشط، ولكن المستخدم لم يضبط مفتاح التشفير. |
ACTIVE_PER_USER |
التشفير نشط، ويرتبط مفتاح التشفير بالملف الشخصي للمستخدم. |
SecurityPosture
الوضع الأمني للجهاز، على النحو الذي يتم تحديده من خلال حالة الجهاز الحالية والسياسات المُطبّقة.
تمثيل JSON |
---|
{ "devicePosture": enum ( |
الحقول | |
---|---|
devicePosture |
قيمة الوضع الأمني للجهاز. |
postureDetails[] |
تفاصيل إضافية حول الوضع الأمني للجهاز. |
DevicePosture
قيم الوضع الأمني المحتملة لجهاز يخضع للإدارة.
عمليات التعداد | |
---|---|
POSTURE_UNSPECIFIED |
غير محدد لا توجد تفاصيل حول الوضعية لقيمة الوضع هذه. |
SECURE |
هذا الجهاز آمن. |
AT_RISK |
قد يكون هذا الجهاز أكثر عرضة للاختراق من الجهات الضارّة أكثر مما يُنصَح باستخدامه مع بيانات الشركة. |
POTENTIALLY_COMPROMISED |
قد يكون هذا الجهاز مخترَقًا وإمكانية وصول جهات غير مصرَّح بها إلى بيانات الشركة. |
PostureDetail
تفاصيل إضافية حول الوضع الأمني للجهاز.
تمثيل JSON |
---|
{ "securityRisk": enum ( |
الحقول | |
---|---|
securityRisk |
هناك خطر أمني معيّن يؤثر سلبًا في الوضع الأمني للجهاز. |
advice[] |
التعليمات المقابلة الموجَّهة للمشرف للحدّ من هذه المخاطر الأمنية وتحسين الوضع الأمني للجهاز. |
SecurityRisk
يشير إلى الخطر الذي يجعل الجهاز ليس في الحالة الأكثر أمانًا.
عمليات التعداد | |
---|---|
SECURITY_RISK_UNSPECIFIED |
غير محدد |
UNKNOWN_OS |
ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز يعمل بنظام تشغيل غير معروف (يتم التحقّق من السلامة الأساسي بنجاح ولكن يتعذّر استخدام ctsProfileMatch). |
COMPROMISED_OS |
ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز يعمل بنظام تشغيل مُعرَّض للاختراق (يتعذّر فحص السلامة الأساسي). |
HARDWARE_BACKED_EVALUATION_FAILED |
ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز لا يوفّر ضمانًا قويًا لسلامة النظام، في حال عدم ظهور تصنيف MEETS_STRONG_INTEGRITY في حقل سلامة الجهاز. |
CommonCriteriaModeInfo
معلومات عن "وضع المعايير المشتركة"، وهي معايير الأمان المحدّدة في المعايير المشتركة لتقييم أمان تكنولوجيا المعلومات (CC).
ولا تتوفّر هذه المعلومات إلا إذا كانت قيمة statusReportingSettings.commonCriteriaModeEnabled
هي true
في سياسة الجهاز.
تمثيل JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
الحقول | |
---|---|
commonCriteriaModeStatus |
ما إذا كان وضع المعايير المشتركة مفعَّلاً أم لا. |
CommonCriteriaModeStatus
ما إذا كان وضع المعايير المشتركة مفعَّلاً أم لا.
عمليات التعداد | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
حالة غير معروفة. |
COMMON_CRITERIA_MODE_DISABLED |
وضع المعايير المشتركة غير مفعّل حاليًا. |
COMMON_CRITERIA_MODE_ENABLED |
وضع المعايير المشتركة مفعّل حاليًا. |
DpcMigrationInfo
معلومات تتعلّق بما إذا كان قد تم نقل هذا الجهاز من وحدة تحكّم أخرى بسياسة الجهاز (DPC)
تمثيل JSON |
---|
{ "previousDpc": string, "additionalData": string } |
الحقول | |
---|---|
previousDpc |
النتائج فقط. إذا تم نقل هذا الجهاز من وحدة التحكّم بسياسة الجهاز (DPC) أخرى، يكون هذا هو اسم الحزمة. لا تتم تعبئة هذا الحقل بخلاف ذلك. |
additionalData |
النتائج فقط. إذا تم نقل هذا الجهاز من وحدة التحكّم بسياسة الجهاز (DPC) أخرى، تتم هنا تعبئة الحقل |
الطُرق |
|
---|---|
|
يؤدي هذا الإجراء إلى حذف جهاز. |
|
الحصول على جهاز. |
|
يصدر أمرًا إلى جهاز. |
|
يسرد الأجهزة لمؤسسة معيّنة. |
|
يحدّث الجهاز. |