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)
  }
}
الحقول
name

string

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

string

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

enum (ManagementMode)

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

enum (DeviceState)

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

enum (DeviceState)

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

boolean

ما إذا كان الجهاز يمتثل للسياسة
nonComplianceDetails[]

object (NonComplianceDetail)

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

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastStatusReportTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

تمّ الإيقاف.

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastPolicySyncTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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 في بعض الحالات.
  • تم ضبط fieldPath استنادًا إلى passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

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

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 الخاصة بالمؤسسة على شهادة CA الجذر أو اسم النطاق. تم ضبط 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.

SpecificNonComplianceContext

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

تمثيل JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
الحقول
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.

OncWifiContext

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

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

string

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

PasswordPoliciesContext

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

تمثيل JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
الحقول
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 (SystemUpdateInfo)
  }
}
الحقول
androidVersion

string

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

integer

رمز إصدار تطبيق Android Device Policy
androidDevicePolicyVersionName

string

إصدار تطبيق Android Device Policy كما يظهر للمستخدم
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)

مدّة التصميم

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
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).

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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
}
الحقول
brand

string

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

string

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

string

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

string

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

string

الرقم التسلسلي للجهاز
model

string

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

number

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

number

حدود درجة الحرارة التي يتم عندها خفض سرعة البطارية بالدرجة المئوية لكل بطارية على الجهاز
cpuShutdownTemperatures[]

number

الحدود القصوى لدرجة حرارة إيقاف وحدة المعالجة المركزية بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز
cpuThrottlingTemperatures[]

number

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

number

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

number

الحدود القصوى لدرجة الحرارة التي تؤدي إلى تقييد وحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز
skinShutdownTemperatures[]

number

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

number

الحدود القصوى لدرجة الحرارة التي يتم عندها خفض سرعة الجهاز بالدرجة المئوية
enterpriseSpecificId

string

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

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

معلومات عرض الجهاز

تمثيل 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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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 (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
الحقول
key

string

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

enum (Severity)

درجة خطورة حالة التطبيق.
message

string

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

string

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

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

درجة الخطورة

شدة حالة التطبيق

عمليات التعداد
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
}
الحقول
phoneNumber

string

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

string

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

string

النتائج فقط. رقم تعريف ICCID المرتبط بشريحة 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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

وقت أخذ القياسات

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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

ما إذا كان ADB مفعَّلاً على الجهاز
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 أنّ الجهاز يعمل بنظام تشغيل مُخترَق (تعذُّر إكمال عملية التحقّق من السلامة الأساسية)
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 على "خطأ".
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED تم التحقّق من صحة توقيع السياسة.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED لا تتوفّر ميزة التحقّق من توقيع السياسة، مثلاً لأنّه تم تسجيل الجهاز باستخدام إصدار CloudDPC لا يتيح التحقّق من توقيع السياسة.
POLICY_SIGNATURE_VERIFICATION_FAILED تعذّر إثبات صحة توقيع السياسة. لم يتم تطبيق السياسة.

DpcMigrationInfo

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

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

string

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

string

النتائج فقط. إذا تم نقل بيانات هذا الجهاز من مركز إدارة بيانات آخر، تتم تعبئة حقل additionalData الخاص برمز نقل البيانات هنا.

الطُرق

delete

 حذف جهاز

get

 الحصول على جهاز.

issueCommand

 يُصدر أمرًا لجهاز.

list

 يسرد الأجهزة لشركة معيّنة.

patch

 تعديلات على جهاز