MCP Tools Reference: Android Device Management MCP Server

الأداة: list_devices

تعرض هذه الطريقة قائمة بالأجهزة لمؤسسة معيّنة. يتطلّب معرّف المؤسسة في الحقل الرئيسي (مثل enterprises/{enterpriseId}).

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_devices MCP.

طلب Curl
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

مخطط الإدخال

طلب إدراج الأجهزة لمؤسسة معيّنة

ListDevicesRequest

تمثيل JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
الحقول
parent

string

اسم المؤسسة بالتنسيق enterprises/{enterpriseId}

pageSize

integer

حجم الصفحة المطلوب. إذا لم يتم تحديدها، سيتم عرض 10 أجهزة كحد أقصى. الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم الأكبر من 100. ويمكن أن تتغيّر هذه الحدود بمرور الوقت.

pageToken

string

رمز مميز يعرّف صفحة من النتائج التي يعرضها الخادم.

مخطط النتائج

ردّ على طلب إدراج الأجهزة لمؤسسة معيّنة

ListDevicesResponse

تمثيل JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
الحقول
devices[]

object (Device)

قائمة الأجهزة

nextPageToken

string

إذا كانت هناك نتائج إضافية، سيتم عرض رمز مميز لاسترداد الصفحة التالية من النتائج.

الجهاز

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

string

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

userName

string

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

managementMode

enum (ManagementMode)

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

state

enum (DeviceState)

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

appliedState

enum (DeviceState)

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

policyCompliant

boolean

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

nonComplianceDetails[]

object (NonComplianceDetail)

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

enrollmentTime

string (Timestamp format)

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

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

lastStatusReportTime

string (Timestamp format)

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

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

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

تمّ الإيقاف.

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

lastPolicySyncTime

string (Timestamp format)

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

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

policyName

string

اسم السياسة المطبَّقة على الجهاز، بالتنسيق enterprises/{enterpriseId}/policies/{policyId} في حال عدم تحديدها، يتم تطبيق policy_name لمستخدم الجهاز. يمكن تعديل هذا الحقل من خلال طلب تصحيح. يمكنك تحديد 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)

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

previousDeviceNames[]

string

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

networkInfo

object (NetworkInfo)

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

memoryInfo

object (MemoryInfo)

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

memoryEvents[]

object (MemoryEvent)

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

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

powerManagementEvents[]

object (PowerManagementEvent)

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

hardwareStatusSamples[]

object (HardwareStatus)

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

deviceSettings

object (DeviceSettings)

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

user

object (User)

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

systemProperties

map (key: string, value: string)

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

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

securityPosture

object (SecurityPosture)

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

ownership

enum (Ownership)

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

commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

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

appliedPasswordPolicies[]

object (PasswordRequirements)

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

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

object (DpcMigrationInfo)

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

defaultApplicationInfo[]

object (DefaultApplicationInfo)

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

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

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)

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

specificNonComplianceReason

enum (SpecificNonComplianceReason)

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

specificNonComplianceContext

object (SpecificNonComplianceContext)

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

القيمة

تمثيل JSON
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
الحقول
حقل الدمج kind تمثّل هذه السمة نوع القيمة. يمكن أن تكون kind إحدى القيم التالية فقط:
nullValue

null

تمثّل قيمة فارغة.

numberValue

number

تمثّل قيمة مزدوجة.

stringValue

string

تمثّل قيمة سلسلة.

boolValue

boolean

تمثّل قيمة منطقية.

structValue

object (Struct format)

تمثّل قيمة منظَّمة.

listValue

array (ListValue format)

تمثّل هذه السمة Value متكرّرة.

Struct

تمثيل JSON
{
  "fields": {
    string: value,
    ...
  }
}
الحقول
fields

map (key: string, value: value (Value format))

خريطة غير مرتبة للقيم ذات الأنواع الديناميكية

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

FieldsEntry

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

string

value

value (Value format)

ListValue

تمثيل JSON
{
  "values": [
    value
  ]
}
الحقول
values[]

value (Value format)

حقل متكرّر للقيم ذات الأنواع الديناميكية

SpecificNonComplianceContext

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

object (OncWifiContext)

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

passwordPoliciesContext

object (PasswordPoliciesContext)

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

defaultApplicationContext

object (DefaultApplicationContext)

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

OncWifiContext

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

string

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

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

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

DefaultApplicationContext

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

enum (DefaultApplicationScope)

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

الطابع الزمني

تمثيل JSON
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة Unix في 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين ‎-62135596800 و253402300799 شاملةً الرقمين (وهو ما يتوافق مع 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59Z).

nanos

integer

أجزاء غير سالبة من الثانية بدقة النانو ثانية هذا الحقل هو جزء من المدة بوحدة النانو ثانية، وليس بديلاً عن الثواني. يجب أن تتضمّن قيم الثواني السالبة التي تتضمّن كسورًا قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك الرقمان.

UserFacingMessage

تمثيل JSON
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
الحقول
localizedMessages

map (key: string, value: string)

خريطة تحتوي على أزواج <locale, message>، حيث locale هو رمز لغة BCP 47 منسّق بشكل جيد، مثل en-US أو es-ES أو fr.

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

defaultMessage

string

الرسالة التلقائية التي يتم عرضها في حال عدم تحديد أي رسالة مترجمة أو إذا كان المكان الجغرافي للمستخدم لا يتطابق مع أي من الرسائل المترجمة يجب تقديم رسالة تلقائية في حال تقديم أي رسائل مترجمة.

LocalizedMessagesEntry

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

string

value

string

SoftwareInfo

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

string

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

androidDevicePolicyVersionCode

integer

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

androidDevicePolicyVersionName

string

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

androidBuildNumber

string

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

deviceKernelVersion

string

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

bootloaderVersion

string

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

androidBuildTime

string (Timestamp format)

مدة الإنشاء

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

securityPatchLevel

string

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

primaryLanguageCode

string

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

deviceBuildSignature

string

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

systemUpdateInfo

object (SystemUpdateInfo)

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

SystemUpdateInfo

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

enum (UpdateStatus)

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

updateReceivedTime

string (Timestamp format)

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

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

HardwareInfo

تمثيل JSON
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
الحقول
brand

string

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

hardware

string

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

deviceBasebandVersion

string

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

manufacturer

string

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

serialNumber

string

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

model

string

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

batteryShutdownTemperatures[]

number

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

batteryThrottlingTemperatures[]

number

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

cpuShutdownTemperatures[]

number

يشير إلى الحدود الدنيا لدرجة حرارة إيقاف وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز.

cpuThrottlingTemperatures[]

number

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

gpuShutdownTemperatures[]

number

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

gpuThrottlingTemperatures[]

number

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

skinShutdownTemperatures[]

number

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

skinThrottlingTemperatures[]

number

عتبات درجة حرارة خفض سرعة وحدة المعالجة المركزية (CPU) لجلد الجهاز بالدرجة المئوية

enterpriseSpecificId

string

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

euiccChipInfo[]

object (EuiccChipInfo)

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

EuiccChipInfo

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

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

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".

KeyedAppState

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

string

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

severity

enum (Severity)

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

message

string

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

data

string

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

createTime

string (Timestamp format)

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

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

lastUpdateTime

string (Timestamp format)

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

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

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

تمثيل 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 لواجهة برمجة التطبيقات.

MemoryInfo

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

string (int64 format)

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

totalInternalStorage

string (int64 format)

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

MemoryEvent

تمثيل 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، السعة الإجمالية لوسيط التخزين بالبايت

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، يمثّل هذا الحقل مستوى شحن البطارية كنسبة مئوية.

HardwareStatus

تمثيل JSON
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
الحقول
createTime

string (Timestamp format)

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

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

batteryTemperatures[]

number

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

cpuTemperatures[]

number

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

gpuTemperatures[]

number

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

skinTemperatures[]

number

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

fanSpeeds[]

number

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

cpuUsages[]

number

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

DeviceSettings

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

boolean

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

unknownSourcesEnabled

boolean

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

developmentSettingsEnabled

boolean

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

adbEnabled

boolean

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

isEncrypted

boolean

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

encryptionStatus

enum (EncryptionStatus)

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

verifyAppsEnabled

boolean

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

المستخدم

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

string

معرّف فريد تنشئه لهذا المستخدم، مثل user342 أو asset#44418. يجب ضبط هذا الحقل عند إنشاء المستخدم، ولا يمكن تعديله. يجب ألا يحتوي هذا الحقل على معلومات تحديد الهوية الشخصية. يجب ألا يزيد طول هذا المعرّف عن 1024 حرفًا، وإلا سيتعذّر تنفيذ طلب سياسة التحديث.

SystemPropertiesEntry

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

string

value

string

SecurityPosture

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

enum (DevicePosture)

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

postureDetails[]

object (PostureDetail)

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

PostureDetail

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

enum (SecurityRisk)

خطر أمني محدّد يؤثّر سلبًا في مستوى أمان الجهاز.

advice[]

object (UserFacingMessage)

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

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

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

policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

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

PasswordRequirements

تمثيل JSON
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
الحقول
passwordMinimumLength

integer

الحد الأدنى المسموح به لطول كلمة المرور تشير القيمة 0 إلى عدم وجود قيود. لا يتم تطبيقها إلا عندما تكون قيمة password_quality هي NUMERIC أو NUMERIC_COMPLEX أو ALPHABETIC أو ALPHANUMERIC أو COMPLEX.

passwordMinimumLetters

integer

الحد الأدنى لعدد الأحرف المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordMinimumLowerCase

integer

الحد الأدنى لعدد الأحرف الصغيرة المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordMinimumNonLetter

integer

الحد الأدنى لعدد الأحرف غير الأبجدية (الأرقام أو الرموز) المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordMinimumNumeric

integer

الحد الأدنى لعدد الأرقام المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordMinimumSymbols

integer

الحد الأدنى لعدد الرموز المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordMinimumUpperCase

integer

الحد الأدنى لعدد الأحرف الكبيرة المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة password_quality هي COMPLEX.

passwordQuality

enum (PasswordQuality)

جودة كلمة المرور المطلوبة

passwordHistoryLength

integer

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

maximumFailedPasswordsForWipe

integer

عدد كلمات المرور غير الصحيحة لفتح قفل الجهاز التي يمكن إدخالها قبل حجب بيانات الجهاز تشير القيمة 0 إلى عدم وجود قيود.

passwordExpirationTimeout

string (Duration format)

مهلة انتهاء صلاحية كلمة المرور

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"

passwordScope

enum (PasswordPolicyScope)

النطاق الذي ينطبق عليه شرط كلمة المرور

requirePasswordUnlock

enum (RequirePasswordUnlock)

هي المدة الزمنية التي يمكن خلالها فتح قفل الجهاز أو ملف العمل باستخدام أي طريقة مصادقة أخرى (مثل بصمة الإصبع أو وكلاء موثوق بهم أو الوجه) بعد فتح قفله باستخدام طريقة مصادقة قوية (كلمة المرور أو رقم التعريف الشخصي أو النقش). بعد انقضاء الفترة الزمنية المحدّدة، لا يمكن استخدام سوى أشكال المصادقة القوية لفتح قفل الجهاز أو ملف العمل.

unifiedLockSettings

enum (UnifiedLockSettings)

يتحكّم هذا الإعداد في ما إذا كان مسموحًا بقفل موحّد للجهاز وملف العمل على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأحدث والتي تتضمّن ملف عمل. لا يمكن ضبط هذا الخيار إلا إذا تم ضبط password_scope على SCOPE_PROFILE، وإلا سيتم رفض السياسة. إذا لم يضبط المستخدم قفل شاشة منفصلاً لتطبيقات العمل وتم ضبط هذا الحقل على REQUIRE_SEPARATE_WORK_LOCK، سيتم تسجيل NonComplianceDetail مع ضبط nonComplianceReason على USER_ACTION.

المدة

تمثيل JSON
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

ثوانٍ موقّعة من الفترة الزمنية يجب أن تتراوح القيمة بين ‎-315,576,000,000 و‎+315,576,000,000، بما في ذلك الرقمان. ملاحظة: يتم احتساب هذه الحدود من خلال: 60 ثانية/دقيقة * 60 دقيقة/ساعة * 24 ساعة/يوم * 365.25 يوم/سنة * 10000 سنة

nanos

integer

أجزاء من الثانية موقّعة بدقة النانو ثانية لمدة الفترة الزمنية. يتم تمثيل المدد الزمنية الأقل من ثانية واحدة بحقل 0 seconds وحقل nanos موجب أو سالب. بالنسبة إلى المدد التي تبلغ ثانية واحدة أو أكثر، يجب أن تكون قيمة الحقل nanos غير صفرية وأن تحمل العلامة نفسها التي يحملها الحقل seconds. يجب أن تتراوح القيمة بين ‎-999,999,999 و‎+999,999,999، بما في ذلك الرقمان.

DpcMigrationInfo

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

string

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

additionalData

string

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

DefaultApplicationInfo

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

enum (DefaultApplicationType)

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

packageName

string

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

defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

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

DefaultApplicationSettingAttempt

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

string

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

attemptOutcome

enum (AttemptOutcome)

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

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌