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)

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

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

مدّة التصميم

يستخدم معيار 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
}
الحقول
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)

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

يستخدم معيار 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".

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) على سبيل المثال، ضبط القيم التي يمكن للمشرف اختيار البحث عنها في وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (مثل "إرسال إشعار إليّ إذا كانت بيانات 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
}
الحقول
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)

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

يستخدم معيار 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

ما إذا كان 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

 تعديل جهاز