REST Resource: enterprises.devices

المورد: الجهاز

جهاز مملوك لمؤسسة ما لم يُذكر خلاف ذلك، تكون جميع الحقول للقراءة فقط ولا يمكن تعديلها باستخدام enterprises.devices.patch.

تمثيل JSON 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
الحقول
name

string

اسم الجهاز بالتنسيق enterprises/{enterpriseId}/devices/{deviceId}
userName

string

اسم المورد للمستخدم الذي يملك هذا الجهاز بالصيغة enterprises/{enterpriseId}/users/{userId}
managementMode

enum (ManagementMode)

نوع وضع الإدارة الذي يتبعه تطبيق "سياسة Android للأجهزة" على الجهاز ويؤثر ذلك في إعدادات السياسات المتاحة.
state

enum (DeviceState)

الحالة التي سيتم تطبيقها على الجهاز. يمكن تعديل هذا الحقل من خلال طلب تصحيح. يُرجى العِلم أنّه عند استدعاء enterprises.devices.patch، تكون ACTIVE وDISABLED القيم المسموح بها فقط. لضبط الجهاز على حالة DELETED، اتّصِل بالرقم enterprises.devices.delete.
appliedState

enum (DeviceState)

تشير هذه السمة إلى الحالة المطبَّقة حاليًا على الجهاز.
policyCompliant

boolean

ما إذا كان الجهاز متوافقًا مع سياسته.
nonComplianceDetails[]

object (NonComplianceDetail)

تفاصيل حول إعدادات السياسة التي لا يتوافق معها الجهاز
enrollmentTime

string (Timestamp format)

وقت تسجيل الجهاز

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

آخر مرة أرسل فيها الجهاز تقرير حالة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

تمّ الإيقاف.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

آخر مرة جلب فيها الجهاز سياسته

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
policyName

string

اسم السياسة المطبَّقة على الجهاز، بالتنسيق enterprises/{enterpriseId}/policies/{policyId} في حال عدم تحديدها، يتم تطبيق policyName لمستخدم الجهاز. يمكن تعديل هذا الحقل من خلال طلب تصحيح. يمكنك تحديد policyId فقط عند طلب enterprises.devices.patch، شرط ألا يحتوي policyId على أي شرطات مائلة. يتم استنتاج بقية اسم السياسة.
appliedPolicyName

string

اسم السياسة المطبَّقة حاليًا على الجهاز
appliedPolicyVersion

string (int64 format)

إصدار السياسة المطبَّقة حاليًا على الجهاز
apiLevel

integer

مستوى واجهة برمجة التطبيقات لإصدار نظام التشغيل Android الذي يعمل على الجهاز
enrollmentTokenData

string

إذا تم تسجيل الجهاز باستخدام رمز مميّز للتسجيل مع توفير بيانات إضافية، يحتوي هذا الحقل على تلك البيانات.
enrollmentTokenName

string

إذا تم تسجيل الجهاز باستخدام رمز مميّز للتسجيل، يحتوي هذا الحقل على اسم الرمز المميّز.
disabledReason

object (UserFacingMessage)

إذا كانت حالة الجهاز DISABLED، تكون هذه رسالة اختيارية يتم عرضها على الجهاز لتوضيح سبب إيقافه. يمكن تعديل هذا الحقل من خلال طلب تصحيح.
softwareInfo

object (SoftwareInfo)

معلومات مفصّلة حول برامج الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة softwareInfoEnabled هي "صحيح" في سياسة الجهاز.
hardwareInfo

object (HardwareInfo)

معلومات مفصّلة حول مكوّنات الجهاز.
displays[]

object (Display)

معلومات مفصّلة حول الشاشات على الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة displayInfoEnabled هي "صحيح" في سياسة الجهاز.
applicationReports[]

object (ApplicationReport)

تقارير عن التطبيقات المثبَّتة على الجهاز لا تتوفّر هذه المعلومات إلا عندما تكون قيمة applicationReportsEnabled صحيحة في سياسة الجهاز.
previousDeviceNames[]

string

إذا تم تسجيل الجهاز الفعلي نفسه عدة مرات، يحتوي هذا الحقل على أسماء الجهاز السابقة. يُستخدَم الرقم التسلسلي كمعرّف فريد لتحديد ما إذا كان الجهاز الفعلي نفسه قد تم تسجيله من قبل. تكون الأسماء مرتَّبة حسب التسلسل الزمني.
networkInfo

object (NetworkInfo)

معلومات شبكة الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة networkInfoEnabled هي "صحيح" في سياسة الجهاز.
memoryInfo

object (MemoryInfo)

معلومات الذاكرة: تحتوي على معلومات حول ذاكرة الجهاز ومساحة التخزين.
memoryEvents[]

object (MemoryEvent)

الأحداث ذات الصلة بقياسات الذاكرة ومساحة التخزين بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة memoryInfoEnabled هي "صحيح" في سياسة الجهاز.

يتم الاحتفاظ بالأحداث لفترة زمنية معيّنة ويتم حذف الأحداث القديمة.
powerManagementEvents[]

object (PowerManagementEvent)

أحداث إدارة الطاقة على الجهاز بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة powerManagementEventsEnabled هي "صحيح" في سياسة الجهاز.
hardwareStatusSamples[]

object (HardwareStatus)

عينات حالة الجهاز بالترتيب الزمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة hardwareStatusEnabled هي "صحيح" في سياسة الجهاز.
deviceSettings

object (DeviceSettings)

معلومات إعدادات الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة deviceSettingsEnabled هي "صحيح" في سياسة الجهاز.
user

object (User)

المستخدم الذي يملك الجهاز
systemProperties

map (key: string, value: string)

خريطة لاسم وقيّمة خصائص النظام المحدّدة المرتبطة بالجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة systemPropertiesEnabled هي "صحيح" في سياسة الجهاز.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
securityPosture

object (SecurityPosture)

قيمة وضع أمان الجهاز التي توضّح مدى أمان الجهاز.
ownership

enum (Ownership)

ملكية الجهاز المُدار
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

معلومات حول "وضع المعايير المشتركة"، أي معايير الأمان المحدّدة في معايير التقييم المشتركة لأمان تكنولوجيا المعلومات (CC).

لا تتوفّر هذه المعلومات إلا إذا كانت قيمة statusReportingSettings.commonCriteriaModeEnabled هي true في سياسة الجهاز التي تنص على أنّ الجهاز مملوك للشركة.
appliedPasswordPolicies[]

object (PasswordRequirements)

متطلبات كلمة المرور المطبَّقة حاليًا على الجهاز

  • يتوفّر هذا الحقل لأنّ المتطلبات المطبَّقة قد تختلف قليلاً عن تلك المحدّدة في passwordPolicies في بعض الحالات.
  • يُرجى العِلم أنّ هذا الحقل لا يقدّم معلومات حول الامتثال لسياسات كلمات المرور. للحصول على معلومات حول عدم الامتثال، يُرجى الاطّلاع على nonComplianceDetails.
  • يتم ضبط NonComplianceDetail.fieldPath استنادًا إلى passwordPolicies وليس استنادًا إلى هذا الحقل.
dpcMigrationInfo

object (DpcMigrationInfo)

النتائج فقط. معلومات حول ما إذا كان قد تم نقل هذا الجهاز من إدارة وحدة تحكّم أخرى في سياسة الجهاز (DPC).
defaultApplicationInfo[]

object (DefaultApplicationInfo)

النتائج فقط. معلومات التطبيق التلقائي لـ DefaultApplicationType لا تتوفّر هذه المعلومات إلا إذا كانت قيمة defaultApplicationInfoReportingEnabled هي "صحيح" في سياسة الجهاز. تتوفّر هذه الميزة على أجهزة Android 16 والإصدارات الأحدث.

يتم إعداد تقارير عن جميع أنواع التطبيقات على الأجهزة الخاضعة للإدارة الكاملة. يتم تسجيل أنواع DEFAULT_BROWSER وDEFAULT_CALL_REDIRECTION وDEFAULT_CALL_SCREENING وDEFAULT_DIALER لملفات العمل على الأجهزة التي تمتلكها الشركة والتي تتضمّن ملف عمل والأجهزة الشخصية. يتم أيضًا تسجيل DEFAULT_WALLET للأجهزة المملوكة للشركة التي تتضمّن ملف عمل، ولكن سيشمل فقط معلومات ملف العمل.

DeviceState

الحالات التي يمكن تطبيقها على جهاز

عمليات التعداد
DEVICE_STATE_UNSPECIFIED هذه القيمة غير مسموح بها.
ACTIVE الجهاز نشط.
DISABLED الجهاز غير مفعّل.
DELETED تم حذف الجهاز. لا يتم عرض هذه الحالة مطلقًا من خلال طلب بيانات من واجهة برمجة التطبيقات، ولكن يتم استخدامها في تقرير الحالة النهائي عندما يقرّ الجهاز بعملية الحذف. إذا تم حذف الجهاز من خلال طلب البيانات من واجهة برمجة التطبيقات، سيتم نشر هذه الحالة في Pub/Sub. إذا حذف المستخدم ملف العمل أو أعاد ضبط الجهاز، ستظل حالة الجهاز غير معروفة للخادم.
PROVISIONING يتم توفير المتطلبات اللازمة للجهاز. تكون الأجهزة المسجَّلة حديثًا في هذه الحالة إلى أن يتم تطبيق سياسة عليها.
LOST الجهاز مفقود. لا يمكن أن تكون الحالة "غير متوافق" إلا على الأجهزة المملوكة للمؤسسة.
PREPARING_FOR_MIGRATION الجهاز يستعدّ لنقل البيانات إلى واجهة برمجة التطبيقات لإدارة Android. ليس عليك اتّخاذ أي إجراء إضافي لمواصلة عملية نقل البيانات.
DEACTIVATED_BY_DEVICE_FINANCE هذا جهاز مموّل تم "قفله" من قِبل وكيل التمويل. وهذا يعني أنّه تم تطبيق بعض إعدادات السياسة التي تحدّ من وظائف الجهاز إلى أن يتم "إلغاء قفله" من قِبل وكيل التمويل. سيواصل الجهاز تطبيق إعدادات السياسة باستثناء تلك التي ألغاها وكيل التمويل. عندما يكون الجهاز "مقفل"، يتم عرض الحالة في appliedState على النحو DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

تقدّم هذه السمة تفاصيل حول عدم الامتثال لإعداد إحدى السياسات.

تمثيل JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
الحقول
settingName

string

اسم إعداد السياسة. هذا هو اسم حقل JSON الخاص بحقل Policy ذي المستوى الأعلى.
nonComplianceReason

enum (NonComplianceReason)

سبب عدم امتثال الجهاز للإعدادات
packageName

string

اسم الحزمة الذي يشير إلى التطبيق غير المتوافق، إذا كان ذلك منطبقًا
fieldPath

string

بالنسبة إلى الإعدادات التي تتضمّن حقولاً متداخلة، إذا كان حقل متداخل معيّن غير متوافق، يحدّد هذا الحقل المسار الكامل إلى الحقل المخالف. يتم تنسيق المسار بالطريقة نفسها التي تتم بها الإشارة إلى حقل JSON الخاص بالسياسة في JavaScript، أي: 1) بالنسبة إلى الحقول من النوع "عنصر"، يتبع اسم الحقل نقطة ثم اسم حقل فرعي. ‫2) بالنسبة إلى الحقول من النوع "مصفوفة"، يتبع اسم الحقل فهرس المصفوفة بين قوسين. على سبيل المثال، للإشارة إلى مشكلة في الحقل url في الحقل externalData في التطبيق الثالث، سيكون المسار applications[2].externalData.url
currentValue

value (Value format)

إذا تعذّر تطبيق إعداد السياسة، ستظهر القيمة الحالية للإعداد على الجهاز.
installationFailureReason

enum (InstallationFailureReason)

إذا تم ضبط packageName وكان سبب عدم الامتثال هو APP_NOT_INSTALLED أو APP_NOT_UPDATED، يوضّح هذا الحقل السبب التفصيلي لتعذُّر تثبيت التطبيق أو تحديثه.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

السبب الخاص بالسياسة الذي يجعل الجهاز غير متوافق مع الإعداد
specificNonComplianceContext

object (SpecificNonComplianceContext)

سياق إضافي لـ specificNonComplianceReason

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

حدث خطأ في الشبكة على جهاز المستخدم، ما أدّى إلى تعذُّر إكمال عملية التثبيت. يحدث ذلك عادةً عندما يكون الاتصال بالإنترنت على الجهاز ضعيفًا أو غير متاح أو عند حدوث مشكلة في إعدادات الشبكة. يُرجى التأكّد من أنّ الجهاز يمكنه الوصول إلى الإنترنت بالكامل على شبكة تستوفي Android Enterprise Network Requirements. سيتم تلقائيًا استئناف عملية تثبيت التطبيق أو تحديثه عند توفّر مساحة كافية.
INSUFFICIENT_STORAGE لا تتوفّر مساحة تخزين كافية على جهاز المستخدم لتثبيت التطبيق. ويمكن حلّ هذه المشكلة من خلال إخلاء مساحة تخزين على الجهاز. سيتم تلقائيًا استئناف عملية تثبيت التطبيق أو تحديثه عندما تتوفّر مساحة تخزين كافية على الجهاز.

SpecificNonComplianceReason

مزيد من التفاصيل حول سبب عدم توافق الجهاز مع أحد إعدادات السياسة يمكن إضافة قيم جديدة إلى التعداد في المستقبل.

عمليات التعداد
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED لم يتم تحديد سبب عدم الامتثال. لم يتم ضبط الحقول في specificNonComplianceContext.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED على المستخدم تأكيد بيانات الاعتماد من خلال إدخال قفل الشاشة. لم يتم ضبط الحقول في specificNonComplianceContext. تم ضبط nonComplianceReason على USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED انتهت صلاحية كلمة مرور الجهاز أو الملف الشخصي. تم ضبط passwordPoliciesContext. تم ضبط nonComplianceReason على USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT لا تستوفي كلمة مرور الجهاز متطلبات كلمة المرور. تم ضبط passwordPoliciesContext. تم ضبط nonComplianceReason على USER_ACTION.
ONC_WIFI_INVALID_VALUE تتضمّن إعدادات شبكة Wi-Fi في ONC قيمة غير صحيحة. تحدّد السمة fieldPath قيمة الحقل غير الصحيحة. تم ضبط oncWifiContext. تم ضبط nonComplianceReason على INVALID_VALUE.
ONC_WIFI_API_LEVEL إعدادات شبكة Wi-Fi بتنسيق ONC غير متاحة في مستوى واجهة برمجة التطبيقات لإصدار Android الذي يعمل على الجهاز. تحدّد fieldPath قيمة الحقل غير المسموح بها. تم ضبط oncWifiContext. تم ضبط nonComplianceReason على API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG لا تتضمّن شبكة Wi-Fi الخاصة بالمؤسسة إما شهادة المرجع المصدّق الجذر أو اسم النطاق. تم ضبط nonComplianceReason على INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK على المستخدم إزالة شبكة Wi-Fi التي تم ضبطها يدويًا. لا ينطبق ذلك إلا على ملفات العمل على الأجهزة التي تملكها شخصيًا. تم ضبط nonComplianceReason على USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY اسم مستعار لزوج المفاتيح تم تحديده من خلال الحقل ClientCertKeyPairAlias في openNetworkConfiguration لا يتوافق مع مفتاح حالي مثبَّت على الجهاز. تم ضبط nonComplianceReason على INVALID_VALUE.
PERMISSIBLE_USAGE_RESTRICTION إعداد السياسة هذا محظور ولا يمكن ضبطه لمشروع Google Cloud Platform هذا. تتوفّر المزيد من التفاصيل (بما في ذلك كيفية تفعيل استخدام إعداد هذه السياسة) في سياسة الاستخدام المسموح به. تم ضبط nonComplianceReason على PROJECT_NOT_PERMITTED.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE لم يعُد حساب العمل المطلوب بموجب إعداد سياسة workAccountSetupConfig جزءًا من المؤسسة. تم ضبط nonComplianceReason على USER_ACTION.
NEW_ACCOUNT_NOT_IN_ENTERPRISE الحساب الخاص بالعمل الذي أضافه المستخدم ليس جزءًا من المؤسسة. تم ضبط nonComplianceReason على USER_ACTION.
DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES

يتم تطبيق إعداد التطبيق التلقائي على النطاقات غير المتوافقة مع وضع الإدارة، حتى إذا كان وضع الإدارة نفسه متوافقًا مع نوع التطبيق (على سبيل المثال، تؤدي السياسة التي تتضمّن نوع التطبيق DEFAULT_BROWSER والقائمة [SCOPE_PERSONAL_PROFILE] المُرسَلة إلى جهاز مُدار بالكامل إلى عدم إمكانية تطبيق النطاقات على وضع الإدارة). إذا كان وضع الإدارة غير متاح لنوع التطبيق، سيتم تسجيل NonComplianceDetail مع MANAGEMENT_MODE، بدون specificNonComplianceReason.

تم ضبط nonComplianceReason على MANAGEMENT_MODE.
DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE تعذّر تطبيق إعداد التطبيق التلقائي لنطاق معيّن. تم ضبط defaultApplicationContext. يجب ضبط قيمة nonComplianceReason على INVALID_VALUE أو APP_NOT_INSTALLED.

SpecificNonComplianceContext

سياق إضافي لـ SpecificNonComplianceReason

تمثيل JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
الحقول
oncWifiContext

object (OncWifiContext)

سياق إضافي لعدم الامتثال المتعلق بإعدادات Wi-Fi الاطّلاع على ONC_WIFI_INVALID_VALUE وONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

سياق إضافي بشأن عدم الامتثال المتعلق بسياسات كلمات المرور يمكنك الاطّلاع على PASSWORD_POLICIES_PASSWORD_EXPIRED وPASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.
defaultApplicationContext

object (DefaultApplicationContext)

النتائج فقط. سياق إضافي لعدم الامتثال المتعلّق بإعدادات التطبيق التلقائية يمكنك الاطّلاع على DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

سياق إضافي لعدم الامتثال المتعلق بإعدادات Wi-Fi

تمثيل JSON 
{
  "wifiGuid": string
}
الحقول
wifiGuid

string

المعرّف الفريد العام (GUID) لإعدادات شبكة Wi-Fi غير المتوافقة

PasswordPoliciesContext

سياق إضافي بشأن عدم الامتثال المتعلق بسياسات كلمات المرور

تمثيل JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
الحقول
passwordPolicyScope

enum (PasswordPolicyScope)

نطاق كلمة المرور غير المتوافقة

DefaultApplicationContext

سياق إضافي لعدم الامتثال المتعلّق بإعدادات التطبيق التلقائية

تمثيل JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
الحقول
defaultApplicationScope

enum (DefaultApplicationScope)

النتائج فقط. نطاق إعداد التطبيق التلقائي غير المتوافق

SoftwareInfo

معلومات عن برامج الجهاز

تمثيل JSON 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
الحقول
androidVersion

string

سلسلة إصدار Android المرئية للمستخدم مثلاً: 6.0.1
androidDevicePolicyVersionCode

integer

رمز إصدار تطبيق "سياسة Android للأجهزة"
androidDevicePolicyVersionName

string

إصدار تطبيق "سياسة أمان Android" كما يظهر للمستخدم
androidBuildNumber

string

سلسلة معرّف إصدار Android مخصّصة للعرض للمستخدم. مثلاً: shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys
deviceKernelVersion

string

إصدار النواة، مثل 2.6.32.9-g103d848
bootloaderVersion

string

رقم إصدار برنامج الإقلاع على النظام، مثل 0.6.7
androidBuildTime

string (Timestamp format)

مدة الإنشاء

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

مستوى رمز تصحيح الأمان، مثل 2016-05-01
primaryLanguageCode

string

رمز لغة IETF BCP 47 للغة الأساسية على الجهاز
deviceBuildSignature

string

تجزئة SHA-256 لـ android.content.pm.Signature المرتبط بحزمة النظام، والتي يمكن استخدامها للتحقّق من عدم تعديل إصدار النظام.
systemUpdateInfo

object (SystemUpdateInfo)

معلومات حول تحديث محتمل للنظام في انتظار المراجعة

SystemUpdateInfo

معلومات حول تحديث محتمل للنظام في انتظار المراجعة

تمثيل JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
الحقول
updateStatus

enum (UpdateStatus)

حالة التحديث: ما إذا كان هناك تحديث ونوعه
updateReceivedTime

string (Timestamp format)

الوقت الذي أصبح فيه التحديث متاحًا لأول مرة تشير القيمة صفر إلى أنّ هذا الحقل لم يتم ضبطه. يتم ضبط هذا الحقل فقط في حال توفّر تحديث (أي أنّ قيمة updateStatus ليست UPDATE_STATUS_UNKNOWN ولا UP_TO_DATE).

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

UpdateStatus

حالة التحديث: ما إذا كان هناك تحديث ونوعه

عمليات التعداد
UPDATE_STATUS_UNKNOWN لا يُعرف ما إذا كان هناك تحديث نظام معلّق. يحدث ذلك مثلاً عندما يكون مستوى واجهة برمجة التطبيقات للجهاز أقل من 26، أو إذا كان إصدار "سياسة أمان Android" قديمًا.
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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
الحقول
brand

string

تمثّل هذه السمة العلامة التجارية للجهاز. مثلاً: Google
hardware

string

اسم الجهاز مثلاً: Angler
deviceBasebandVersion

string

إصدار النطاق الأساسي مثلاً: MDM9625_104662.22.05.34p
manufacturer

string

الشركة المصنّعة مثلاً: Motorola
serialNumber

string

الرقم التسلسلي للجهاز ومع ذلك، بالنسبة إلى الأجهزة الشخصية التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأحدث، يكون هذا الإعداد هو نفسه enterpriseSpecificId.
model

string

طراز الجهاز مثلاً: Asus Nexus 7
batteryShutdownTemperatures[]

number

يشير إلى الحدود الدنيا لدرجة الحرارة التي يتم عندها إيقاف تشغيل البطارية بالدرجة المئوية لكل بطارية على الجهاز.
batteryThrottlingTemperatures[]

number

يشير إلى حدود درجة الحرارة بالدرجة المئوية لكل بطارية في الجهاز التي تؤدي إلى خفض أداء البطارية.
cpuShutdownTemperatures[]

number

تمثّل هذه السمة الحدود الدنيا لدرجة حرارة إيقاف وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز.
cpuThrottlingTemperatures[]

number

يشير إلى الحدود القصوى لدرجة حرارة تقييد وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز.
gpuShutdownTemperatures[]

number

يشير إلى حدود إيقاف تشغيل وحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز.
gpuThrottlingTemperatures[]

number

يشير إلى الحدود القصوى لدرجة الحرارة التي يتم عندها تقييد وحدة معالجة الرسومات (GPU) بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز.
skinShutdownTemperatures[]

number

الحدود القصوى لدرجة حرارة سطح الجهاز التي تؤدي إلى إيقافه، وذلك بالدرجة المئوية.
skinThrottlingTemperatures[]

number

عتبات درجة حرارة الجلد التي تؤدي إلى خفض سرعة وحدة المعالجة المركزية (CPU) في الجهاز، وذلك بالدرجة المئوية.
enterpriseSpecificId

string

النتائج فقط. معرّف يحدّد بشكل فريد جهازًا مملوكًا شخصيًا في مؤسسة معيّنة. على الجهاز الفعلي نفسه عند التسجيل في المؤسسة نفسها، يظلّ هذا المعرّف ثابتًا في عمليات الإعداد وحتى في عمليات إعادة الضبط على الإعدادات الأصلية. يتوفّر رقم التعريف هذا على الأجهزة الشخصية التي تتضمّن ملف عمل على الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأحدث.
euiccChipInfo[]

object (EuiccChipInfo)

النتائج فقط. معلومات متعلّقة بشريحة eUICC

EuiccChipInfo

معلومات متعلّقة بشريحة eUICC

تمثيل JSON 
{
  "eid": string
}
الحقول
eid

string

النتائج فقط. مستند الهوية المضمّن (EID) الذي يحدّد شريحة eUICC لكل شريحة eUICC على الجهاز تتوفّر هذه الميزة على الأجهزة المملوكة للشركة التي تعمل بالإصدار 13 من نظام التشغيل Android والإصدارات الأحدث.

الشبكة الإعلانية

معلومات شاشة الجهاز

تمثيل JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
الحقول
name

string

اسم الشاشة
displayId

integer

معرّف العرض الفريد
refreshRate

integer

معدّل تحديث الشاشة باللقطات في الثانية
state

enum (DisplayState)

حالة الشاشة
width

integer

عرض الشاشة بالبكسل.
height

integer

تمثّل هذه السمة ارتفاع الشاشة بالبكسل.
density

integer

تمثّل هذه السمة كثافة العرض معبّرًا عنها بالنقاط في البوصة.

DisplayState

تمثّل هذه السمة حالة شاشة العرض.

عمليات التعداد
DISPLAY_STATE_UNSPECIFIED هذه القيمة غير مسموح بها.
OFF الشاشة مطفأة.
ON شاشة العرض مفعَّلة.
DOZE تكون الشاشة في وضع السكون مع استهلاك منخفض للطاقة
SUSPENDED تكون شاشة العرض في وضع السكون في حالة تعليق منخفضة الطاقة.

ApplicationReport

المعلومات التي يتم إعداد تقارير عنها بشأن تطبيق مثبَّت

تمثيل JSON 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
الحقول
packageName

string

اسم حزمة التطبيق
versionName

string

تمثّل هذه السمة إصدار التطبيق كما يظهر للمستخدم.
versionCode

integer

رمز إصدار التطبيق، الذي يمكن استخدامه لتحديد ما إذا كان أحد الإصدارات أحدث من إصدار آخر.
events[]

object (ApplicationEvent)

قائمة بأحداث التطبيق التي وقعت في آخر 30 ساعة
displayName

string

الاسم المعروض للتطبيق
packageSha256Hash

string

تجزئة SHA-256 لملف APK الخاص بالتطبيق، والتي يمكن استخدامها للتحقّق من عدم تعديل التطبيق يتم تمثيل كل بايت من قيمة التجزئة كرقم سداسي عشري مكوّن من رقمين.
signingKeyCertFingerprints[]

string

تجزئة SHA-1 لكل android.content.pm.Signature مرتبط بحزمة التطبيق يتم تمثيل كل بايت من كل قيمة تجزئة كرقم سداسي عشري مكوّن من رقمين.
installerPackageName

string

اسم حزمة التطبيق الذي ثبّت هذا التطبيق
applicationSource

enum (ApplicationSource)

مصدر الحزمة
state

enum (ApplicationState)

حالة التطبيق
keyedAppStates[]

object (KeyedAppState)

قائمة بحالات التطبيق التي تم إدخال مفتاح لها والتي أبلغ عنها التطبيق.
userFacingType

enum (UserFacingType)

تُستخدَم لتحديد ما إذا كان التطبيق موجّهًا للمستخدمين.

ApplicationEvent

حدث مرتبط بتطبيق

تمثيل JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
الحقول
eventType

enum (ApplicationEventType)

نوع حدث التطبيق
createTime

string (Timestamp format)

وقت إنشاء الحدث

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

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".
CUSTOM تم تثبيت التطبيق باستخدام أمر حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات AMAPI. يُرجى الاطّلاع أيضًا على: CUSTOM

ApplicationState

حالة التثبيت الحالية

عمليات التعداد
APPLICATION_STATE_UNSPECIFIED حالة التطبيق غير محدَّدة
REMOVED تمت إزالة التطبيق من الجهاز
INSTALLED التطبيق مثبَّت على الجهاز

KeyedAppState

حالة التطبيق التي تم إدخال مفتاح لها وأبلغ عنها التطبيق

تمثيل JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
الحقول
key

string

مفتاح حالة التطبيق. تعمل هذه السمة كنقطة مرجعية لما يوفّره التطبيق من حالة. على سبيل المثال، عند تقديم ملاحظات حول الإعدادات المُدارة، يمكن أن يكون هذا المفتاح هو مفتاح الإعدادات المُدارة.
severity

enum (Severity)

تمثّل هذه السمة مستوى خطورة حالة التطبيق.
message

string

سلسلة رسائل ذات تنسيق حر لشرح حالة التطبيق (اختيارية). إذا تم تفعيل الحالة بواسطة قيمة معيّنة (مثل قيمة إعداد مُدار)، يجب تضمينها في الرسالة.
data

string

قيمة اختيارية يمكن قراءتها آليًا من قِبل إدارة الخدمات الجوّالة للمؤسسات (EMM). على سبيل المثال، ضبط القيم التي يمكن للمشرف اختيار طلب البحث عنها في وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM) (مثل "إرسال إشعار إليّ إذا كانت بيانات battery_warning < 10").
createTime

string (Timestamp format)

وقت إنشاء حالة التطبيق على الجهاز.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

الوقت الذي تم فيه تعديل حالة التطبيق مؤخرًا

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

درجة الخطورة

تمثّل هذه السمة مستوى خطورة حالة التطبيق.

عمليات التعداد
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 (TelephonyInfo)
    }
  ]
}
الحقول
imei

string

رقم IMEI لجهاز GSM مثلاً: A1000031212
meid

string

رقم تعريف الأجهزة الجوّالة (MEID) لجهاز CDMA مثلاً: A00000292788E1
wifiMacAddress

string

عنوان MAC لشبكة Wi-Fi للجهاز مثلاً: 7c:11:11:11:11:11
networkOperatorName
(deprecated)

string

الاسم الأبجدي للمشغّل المسجّل الحالي على سبيل المثال، Vodafone.
telephonyInfos[]

object (TelephonyInfo)

توفّر هذه السمة معلومات الاتصال المرتبطة بكل شريحة SIM على الجهاز. لا تتوفّر إلا على الأجهزة المُدارة بالكامل التي تعمل بالإصدار 23 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث.

TelephonyInfo

معلومات الاتصالات الهاتفية المرتبطة بشريحة SIM معيّنة على الجهاز لا تتوفّر إلا على الأجهزة المُدارة بالكامل التي تعمل بالإصدار 23 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث.

تمثيل JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
الحقول
phoneNumber

string

رقم الهاتف المرتبط بشريحة SIM هذه
carrierName

string

اسم مشغّل شبكة الجوّال المرتبط بشريحة SIM هذه
iccId

string

النتائج فقط. رقم ICCID المرتبط بشريحة SIM هذه
activationState

enum (ActivationState)

النتائج فقط. حالة تفعيل شريحة SIM على الجهاز ينطبق ذلك على شرائح eSIM فقط. تتوفّر هذه الميزة على جميع الأجهزة التي تعمل بالمستوى 35 لواجهة برمجة التطبيقات والإصدارات الأحدث. تكون هذه القيمة دائمًا ACTIVATION_STATE_UNSPECIFIED لشرائح SIM الفعلية والأجهزة التي تعمل بإصدار أقدم من المستوى 35 لواجهة برمجة التطبيقات.
configMode

enum (ConfigMode)

النتائج فقط. وضع إعدادات شريحة SIM على الجهاز ينطبق ذلك على شرائح eSIM فقط. تتوفّر هذه الميزة على جميع الأجهزة التي تعمل بالمستوى 35 لواجهة برمجة التطبيقات والإصدارات الأحدث. تكون هذه القيمة دائمًا CONFIG_MODE_UNSPECIFIED لشرائح SIM الفعلية والأجهزة التي تعمل بإصدار أقدم من المستوى 35 لواجهة برمجة التطبيقات.

ActivationState

حالة تفعيل شريحة SIM على الجهاز

عمليات التعداد
ACTIVATION_STATE_UNSPECIFIED لم يتم تحديد حالة التفعيل.
ACTIVATED شريحة SIM مفعَّلة.
NOT_ACTIVATED شريحة SIM غير مفعَّلة.

ConfigMode

وضع إعدادات شريحة SIM على الجهاز

عمليات التعداد
CONFIG_MODE_UNSPECIFIED لم يتم تحديد وضع الإعداد.
ADMIN_CONFIGURED أعدّ المشرف شريحة SIM هذه.
USER_CONFIGURED ضبط المستخدم إعدادات شريحة SIM هذه.

MemoryInfo

معلومات عن ذاكرة الجهاز ومساحة التخزين

تمثيل JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
الحقول
totalRam

string (int64 format)

إجمالي سعة ذاكرة الوصول العشوائي (RAM) على الجهاز بالبايت
totalInternalStorage

string (int64 format)

إجمالي مساحة التخزين الداخلية على الجهاز بالبايت

MemoryEvent

حدث مرتبط بقياسات الذاكرة ومساحة التخزين

للتفريق بين الأحداث الجديدة والقديمة، ننصحك باستخدام الحقل createTime.

تمثيل JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
الحقول
eventType

enum (MemoryEventType)

نوع الحدث.
createTime

string (Timestamp format)

وقت إنشاء الحدث

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

عدد وحدات البايت المجانية في الوسيط، أو بالنسبة إلى EXTERNAL_STORAGE_DETECTED، السعة الإجمالية لوسيط التخزين بالبايت

MemoryEventType

نوع الحدث.

عمليات التعداد
MEMORY_EVENT_TYPE_UNSPECIFIED غير محدد لا تتضمّن أي أحداث هذا النوع.
RAM_MEASURED تم قياس المساحة الخالية في ذاكرة الوصول العشوائي.
INTERNAL_STORAGE_MEASURED تم قياس المساحة المتوفّرة في وحدة التخزين الداخلية.
EXTERNAL_STORAGE_DETECTED تم رصد وسيط تخزين خارجي جديد. عدد وحدات البايت المُبلَغ عنها هو إجمالي سعة وسيط التخزين.
EXTERNAL_STORAGE_REMOVED تمت إزالة وسيط تخزين خارجي. عدد وحدات البايت المُبلغ عنه هو صفر.
EXTERNAL_STORAGE_MEASURED تم قياس المساحة الحرة في وسيط تخزين خارجي.

PowerManagementEvent

حدث لإدارة الطاقة

تمثيل JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
الحقول
eventType

enum (PowerManagementEventType)

نوع الحدث.
createTime

string (Timestamp format)

وقت إنشاء الحدث

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
batteryLevel

number

بالنسبة إلى أحداث BATTERY_LEVEL_COLLECTED، يمثّل هذا الحقل مستوى شحن البطارية كنسبة مئوية.

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

string (Timestamp format)

الوقت الذي تم فيه أخذ القياسات

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

درجات حرارة البطارية الحالية بالدرجة المئوية لكل بطارية على الجهاز
cpuTemperatures[]

number

درجات حرارة وحدة المعالجة المركزية الحالية بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز
gpuTemperatures[]

number

درجات حرارة وحدة معالجة الرسومات الحالية بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز
skinTemperatures[]

number

درجات حرارة سطح الجهاز الحالية بالدرجة المئوية
fanSpeeds[]

number

سرعات المراوح في الدقيقة لكل مروحة على الجهاز تعني المصفوفة الفارغة أنّه لا توجد مراوح أو أنّ سرعة المروحة غير متاحة على النظام.
cpuUsages[]

number

استخدامات وحدة المعالجة المركزية (CPU) بالنسبة المئوية لكل نواة متاحة على الجهاز يكون الاستخدام 0 لكل نواة غير موصولة. يشير المصفوفة الفارغة إلى أنّ استخدام وحدة المعالجة المركزية غير متاح في النظام.

DeviceSettings

معلومات عن إعدادات الجهاز المتعلّقة بالأمان

تمثيل JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
الحقول
isDeviceSecure

boolean

تحديد ما إذا كان الجهاز مؤمَّنًا برقم تعريف شخصي أو كلمة مرور
unknownSourcesEnabled

boolean

تُستخدَم لتحديد ما إذا كان مسموحًا بتثبيت التطبيقات من مصادر غير معروفة.
developmentSettingsEnabled

boolean

تحديد ما إذا كان "وضع المطوّر" مفعَّلاً على الجهاز
adbEnabled

boolean

تحديد ما إذا كان تصحيح أخطاء Android مفعَّلاً على الجهاز
isEncrypted

boolean

تُستخدَم لتحديد ما إذا كان تشفير مساحة التخزين مفعَّلاً.
encryptionStatus

enum (EncryptionStatus)

حالة التشفير من DevicePolicyManager
verifyAppsEnabled

boolean

تحديد ما إذا كان سيتم فرض التحقّق من Google Play للحماية على الجهاز

EncryptionStatus

حالة تشفير الجهاز

عمليات التعداد
ENCRYPTION_STATUS_UNSPECIFIED غير محدد يجب ألا يكون لأي جهاز هذا النوع.
UNSUPPORTED لا يتيح الجهاز التشفير.
INACTIVE يتوافق الجهاز مع التشفير، ولكنّه غير مفعّل حاليًا.
ACTIVATING التشفير غير مفعَّل حاليًا، ولكنّه قيد التفعيل.
ACTIVE التشفير مفعّل.
ACTIVE_DEFAULT_KEY التشفير مفعَّل، ولكن لم يضبط المستخدم مفتاح تشفير.
ACTIVE_PER_USER التشفير مفعّل، ومفتاح التشفير مرتبط بملف المستخدم الشخصي.

SecurityPosture

مستوى أمان الجهاز، كما هو محدّد بحالة الجهاز الحالية والسياسات المطبَّقة

تمثيل JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
الحقول
devicePosture

enum (DevicePosture)

قيمة وضع أمان الجهاز
postureDetails[]

object (PostureDetail)

تفاصيل إضافية حول مستوى أمان الجهاز.

DevicePosture

قيم وضع الأمان المحتملة لجهاز خاضع للإدارة

عمليات التعداد
POSTURE_UNSPECIFIED غير محدد لا تتوفّر تفاصيل عن وضعية الجسم هذه.
SECURE هذا الجهاز آمن.
AT_RISK قد يكون هذا الجهاز أكثر عرضةً للجهات الضارة من الحدّ الموصى به للاستخدام مع بيانات الشركة.
POTENTIALLY_COMPROMISED قد يكون هذا الجهاز معرَّضًا للخطر، وقد يتمكّن جهات غير مصرَّح لها من الوصول إلى بيانات الشركة.

PostureDetail

تفاصيل إضافية حول مستوى أمان الجهاز.

تمثيل JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
الحقول
securityRisk

enum (SecurityRisk)

خطر أمان محدّد يؤثّر سلبًا في حالة أمان الجهاز.
advice[]

object (UserFacingMessage)

نصائح موجّهة إلى المشرفين للحدّ من هذا الخطر الأمني وتحسين مستوى أمان الجهاز

SecurityRisk

الخطر الذي يجعل الجهاز في حالة غير آمنة.

عمليات التعداد
SECURITY_RISK_UNSPECIFIED غير محدد
UNKNOWN_OS ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز يعمل بنظام تشغيل غير معروف (تنجح عملية التحقّق basicIntegrity ولكن لا تجتاز عملية التحقّق ctsProfileMatch).
COMPROMISED_OS ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز يشغّل نظام تشغيل تم اختراقه (لا يجتاز عملية التحقّق basicIntegrity).
HARDWARE_BACKED_EVALUATION_FAILED ترصد واجهة برمجة التطبيقات Play Integrity API أنّ الجهاز لا يضمن سلامة النظام إلى حدٍ كبير، وذلك في حال عدم ظهور التصنيف MEETS_STRONG_INTEGRITY في حقل سلامة الجهاز.

CommonCriteriaModeInfo

معلومات حول "وضع المعايير المشتركة"، أي معايير الأمان المحدّدة في معايير التقييم المشتركة لأمان تكنولوجيا المعلومات (CC).

لا تتوفّر هذه المعلومات إلا إذا كانت statusReportingSettings.commonCriteriaModeEnabled true في سياسة الجهاز.

تمثيل JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
الحقول
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

تحدّد هذه السمة ما إذا كان "وضع المعايير المشتركة" مفعَّلاً.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

النتائج فقط. حالة إثبات صحة توقيع السياسة

CommonCriteriaModeStatus

تحدّد هذه السمة ما إذا كان "وضع المعايير المشتركة" مفعَّلاً.

عمليات التعداد
COMMON_CRITERIA_MODE_STATUS_UNKNOWN حالة غير معروفة.
COMMON_CRITERIA_MODE_DISABLED وضع "المعايير المشتركة" غير مفعَّل حاليًا.
COMMON_CRITERIA_MODE_ENABLED وضع "المعايير المشتركة" مفعَّل حاليًا.

PolicySignatureVerificationStatus

حالة إثبات صحة توقيع السياسة

عمليات التعداد
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED غير محدد لم يتم الإبلاغ عن حالة إثبات الملكية. يتم ضبط هذه السمة فقط إذا كانت قيمة statusReportingSettings.commonCriteriaModeEnabled هي "خطأ".
POLICY_SIGNATURE_VERIFICATION_DISABLED تم إيقاف التحقّق من توقيع السياسة على الجهاز لأنّ قيمة commonCriteriaMode مضبوطة على "false".
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED تم التأكّد من صحة توقيع السياسة بنجاح.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED لا تتوفّر إمكانية التحقّق من توقيع السياسة، مثلاً لأنّ الجهاز تم تسجيله باستخدام إصدار من CloudDPC لا يتيح التحقّق من توقيع السياسة.
POLICY_SIGNATURE_VERIFICATION_FAILED تعذّر التحقّق من توقيع السياسة. لم يتم تطبيق السياسة.

DpcMigrationInfo

معلومات حول ما إذا كان قد تم نقل هذا الجهاز من إدارة وحدة تحكّم أخرى في سياسة الجهاز (DPC).

تمثيل JSON 
{
  "previousDpc": string,
  "additionalData": string
}
الحقول
previousDpc

string

النتائج فقط. إذا تم نقل هذا الجهاز من أداة أخرى لإدارة سياسات الجهاز (DPC)، سيكون هذا هو اسم الحزمة. ولا تتم تعبئته في الحالات الأخرى.
additionalData

string

النتائج فقط. إذا تم نقل هذا الجهاز من أداة أخرى لإدارة سياسات الجهاز (DPC)، سيتم ملء حقل additionalData لرمز الترحيل هنا.

DefaultApplicationInfo

معلومات التطبيق التلقائي DefaultApplicationType معيّن

تمثيل JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
الحقول
defaultApplicationType

enum (DefaultApplicationType)

النتائج فقط. نوع التطبيق التلقائي
packageName

string

النتائج فقط. اسم حزمة التطبيق التلقائي الحالي
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

النتائج فقط. تفاصيل عن محاولات ضبط التطبيق التلقائي، بالترتيب نفسه الوارد في defaultApplications

DefaultApplicationSettingAttempt

تفاصيل عن محاولة ضبط إعداد تلقائي للتطبيق

تمثيل JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
الحقول
packageName

string

النتائج فقط. اسم حزمة التطبيق الذي تمت محاولة الوصول إليه
attemptOutcome

enum (AttemptOutcome)

النتائج فقط. نتيجة ضبط التطبيق كتطبيق تلقائي

AttemptOutcome

نتيجة ضبط التطبيق كتطبيق تلقائي

عمليات التعداد
ATTEMPT_OUTCOME_UNSPECIFIED لم يتم تحديد نتيجة المحاولة. لا يتم استخدام هذا الحقل.
SUCCESS تم ضبط التطبيق كتطبيق تلقائي بنجاح.
APP_NOT_INSTALLED تعذّرت المحاولة لأنّ التطبيق غير مثبَّت.
APP_SIGNING_CERT_MISMATCH تعذّر إجراء المحاولة لأنّ بصمة شهادة مفتاح توقيع التطبيق من "متجر Play" أو من ApplicationPolicy.signingKeyCerts لا تتطابق مع تلك الموجودة على الجهاز.
OTHER_FAILURE تعذّر إكمال المحاولة لأسباب أخرى.

الطُرق

delete

 يحذف هذا الإجراء جهازًا.

get

 تعرض هذه الطريقة جهازًا.

issueCommand

 يُصدر هذا الإجراء أمرًا إلى جهاز.

list

 تعرض هذه الطريقة قائمة بالأجهزة لمؤسسة معيّنة.

patch

 تعديل جهاز