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 للأجهزة" على الجهاز يؤثر ذلك في إعدادات السياسات المتاحة.
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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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.
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.

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 للأجهزة"
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-normalized ويستخدم 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-normalized ويستخدم 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

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

string

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

string (Timestamp format)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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 أنّ الجهاز يشغّل نظام تشغيل تم اختراقه (لا يجتاز عملية التحقّق 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 لرمز الترحيل هنا.

الطُرق

delete

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

get

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

issueCommand

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

list

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

patch

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