الأداة: 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 |
اسم المؤسسة بالتنسيق |
pageSize |
حجم الصفحة المطلوب. إذا لم يتم تحديدها، سيتم عرض 10 أجهزة كحد أقصى. الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم الأكبر من 100. ويمكن أن تتغيّر هذه الحدود بمرور الوقت. |
pageToken |
رمز مميز يعرّف صفحة من النتائج التي يعرضها الخادم. |
مخطط النتائج
ردّ على طلب إدراج الأجهزة لمؤسسة معيّنة
ListDevicesResponse
| تمثيل JSON |
|---|
{
"devices": [
{
object ( |
| الحقول | |
|---|---|
devices[] |
قائمة الأجهزة |
nextPageToken |
إذا كانت هناك نتائج إضافية، سيتم عرض رمز مميز لاسترداد الصفحة التالية من النتائج. |
الجهاز
| تمثيل JSON |
|---|
{ "name": string, "userName": string, "managementMode": enum ( |
| الحقول | |
|---|---|
name |
اسم الجهاز بالتنسيق |
userName |
اسم المورد للمستخدم الذي يملك هذا الجهاز بالصيغة |
managementMode |
نوع وضع الإدارة الذي يتبعه تطبيق "سياسة Android للأجهزة" على الجهاز ويؤثر ذلك في إعدادات السياسات المتاحة. |
state |
الحالة التي سيتم تطبيقها على الجهاز. يمكن تعديل هذا الحقل من خلال طلب تصحيح. يُرجى العِلم أنّه عند استدعاء |
appliedState |
تشير هذه السمة إلى الحالة المطبَّقة حاليًا على الجهاز. |
policyCompliant |
ما إذا كان الجهاز متوافقًا مع سياسته. |
nonComplianceDetails[] |
تفاصيل حول إعدادات السياسة التي لا يتوافق معها الجهاز |
enrollmentTime |
وقت تسجيل الجهاز يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
lastStatusReportTime |
آخر مرة أرسل فيها الجهاز تقرير حالة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
lastPolicyComplianceReportTime |
تمّ الإيقاف. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
lastPolicySyncTime |
آخر مرة جلب فيها الجهاز سياسته يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
policyName |
اسم السياسة المطبَّقة على الجهاز، بالتنسيق |
appliedPolicyName |
اسم السياسة المطبَّقة حاليًا على الجهاز |
appliedPolicyVersion |
إصدار السياسة المطبَّقة حاليًا على الجهاز |
apiLevel |
مستوى واجهة برمجة التطبيقات لإصدار نظام التشغيل Android الذي يعمل على الجهاز |
enrollmentTokenData |
إذا تم تسجيل الجهاز باستخدام رمز مميّز للتسجيل مع توفير بيانات إضافية، يحتوي هذا الحقل على تلك البيانات. |
enrollmentTokenName |
إذا تم تسجيل الجهاز باستخدام رمز مميّز للتسجيل، يحتوي هذا الحقل على اسم الرمز المميّز. |
disabledReason |
إذا كانت حالة الجهاز |
softwareInfo |
معلومات مفصّلة حول برامج الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
hardwareInfo |
معلومات مفصّلة حول مكوّنات الجهاز. |
displays[] |
معلومات مفصّلة حول الشاشات على الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
applicationReports[] |
تقارير عن التطبيقات المثبَّتة على الجهاز لا تتوفّر هذه المعلومات إلا عندما تكون قيمة |
previousDeviceNames[] |
إذا تم تسجيل الجهاز الفعلي نفسه عدة مرات، يحتوي هذا الحقل على أسماء الجهاز السابقة. يُستخدَم الرقم التسلسلي كمعرّف فريد لتحديد ما إذا كان الجهاز الفعلي نفسه قد تم تسجيله من قبل. تكون الأسماء مرتّبة حسب التسلسل الزمني. |
networkInfo |
معلومات شبكة الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
memoryInfo |
معلومات الذاكرة: تحتوي على معلومات حول ذاكرة الجهاز ومساحة التخزين. |
memoryEvents[] |
الأحداث ذات الصلة بقياسات الذاكرة ومساحة التخزين بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة يتم الاحتفاظ بالأحداث لفترة زمنية معيّنة ويتم حذف الأحداث القديمة. |
powerManagementEvents[] |
أحداث إدارة الطاقة على الجهاز بترتيب زمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
hardwareStatusSamples[] |
عينات حالة الجهاز بالترتيب الزمني لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
deviceSettings |
معلومات إعدادات الجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
user |
المستخدم الذي يملك الجهاز |
systemProperties |
خريطة لاسم وقيّمة خصائص النظام المحدّدة المرتبطة بالجهاز لا تتوفّر هذه المعلومات إلا إذا كانت قيمة عنصر يحتوي على قائمة بأزواج |
securityPosture |
قيمة وضع أمان الجهاز التي توضّح مدى أمان الجهاز. |
ownership |
ملكية الجهاز المُدار |
commonCriteriaModeInfo |
معلومات حول "وضع المعايير المشتركة"، أي معايير الأمان المحدّدة في معايير التقييم المشتركة لأمان تكنولوجيا المعلومات (CC). لا تتوفّر هذه المعلومات إلا إذا كانت قيمة |
appliedPasswordPolicies[] |
متطلبات كلمة المرور المطبَّقة حاليًا على الجهاز
|
dpcMigrationInfo |
النتائج فقط. معلومات حول ما إذا كان قد تم نقل هذا الجهاز من إدارة وحدة تحكّم أخرى في سياسة الجهاز (DPC). |
defaultApplicationInfo[] |
النتائج فقط. معلومات التطبيق التلقائية الخاصة بـ يتم إعداد تقارير عن جميع أنواع التطبيقات على الأجهزة المُدارة بالكامل. يتم تسجيل أنواع |
NonComplianceDetail
| تمثيل JSON |
|---|
{ "settingName": string, "nonComplianceReason": enum ( |
| الحقول | |
|---|---|
settingName |
اسم إعداد السياسة. هذا هو اسم حقل JSON الخاص بحقل |
nonComplianceReason |
سبب عدم امتثال الجهاز للإعدادات |
packageName |
اسم الحزمة الذي يشير إلى التطبيق الذي لا يلتزم بالسياسات، إذا كان ذلك منطبقًا |
fieldPath |
بالنسبة إلى الإعدادات التي تتضمّن حقولاً متداخلة، إذا كان حقل متداخل معيّن غير متوافق، يحدّد هذا الحقل المسار الكامل إلى الحقل المخالف. يتم تنسيق المسار بالطريقة نفسها التي تتم بها الإشارة إلى حقل JSON الخاص بالسياسة في JavaScript، أي: 1) بالنسبة إلى الحقول من النوع "عنصر"، يتبع اسم الحقل نقطة ثم اسم حقل فرعي. 2) بالنسبة إلى الحقول من النوع "مصفوفة"، يتبع اسم الحقل فهرس المصفوفة بين قوسين. على سبيل المثال، للإشارة إلى مشكلة في الحقل |
currentValue |
إذا تعذّر تطبيق إعداد السياسة، ستظهر القيمة الحالية للإعداد على الجهاز. |
installationFailureReason |
إذا تم ضبط |
specificNonComplianceReason |
السبب الخاص بالسياسة الذي يجعل الجهاز غير متوافق مع الإعداد |
specificNonComplianceContext |
سياق إضافي لـ |
القيمة
| تمثيل JSON |
|---|
{ // Union field |
| الحقول | |
|---|---|
حقل الدمج kind تمثّل هذه السمة نوع القيمة. يمكن أن تكون kind إحدى القيم التالية فقط: |
|
nullValue |
تمثّل قيمة فارغة. |
numberValue |
تمثّل قيمة مزدوجة. |
stringValue |
تمثّل قيمة سلسلة. |
boolValue |
تمثّل قيمة منطقية. |
structValue |
تمثّل قيمة منظَّمة. |
listValue |
تمثّل هذه السمة |
Struct
| تمثيل JSON |
|---|
{ "fields": { string: value, ... } } |
| الحقول | |
|---|---|
fields |
خريطة غير مرتبة للقيم ذات الأنواع الديناميكية عنصر يحتوي على قائمة بأزواج |
FieldsEntry
| تمثيل JSON |
|---|
{ "key": string, "value": value } |
| الحقول | |
|---|---|
key |
|
value |
|
ListValue
| تمثيل JSON |
|---|
{ "values": [ value ] } |
| الحقول | |
|---|---|
values[] |
حقل متكرّر للقيم ذات الأنواع الديناميكية |
SpecificNonComplianceContext
| تمثيل JSON |
|---|
{ "oncWifiContext": { object ( |
| الحقول | |
|---|---|
oncWifiContext |
سياق إضافي بشأن عدم الامتثال المتعلق بإعدادات Wi-Fi الاطّلاع على |
passwordPoliciesContext |
سياق إضافي بشأن عدم الامتثال لسياسات كلمات المرور يمكنك الاطّلاع على |
defaultApplicationContext |
النتائج فقط. سياق إضافي لعدم الامتثال المتعلّق بإعدادات التطبيق التلقائية يمكنك الاطّلاع على |
OncWifiContext
| تمثيل JSON |
|---|
{ "wifiGuid": string } |
| الحقول | |
|---|---|
wifiGuid |
المعرّف الفريد العام (GUID) لإعدادات شبكة Wi-Fi غير المتوافقة |
PasswordPoliciesContext
| تمثيل JSON |
|---|
{
"passwordPolicyScope": enum ( |
| الحقول | |
|---|---|
passwordPolicyScope |
نطاق كلمة المرور غير المتوافقة |
DefaultApplicationContext
| تمثيل JSON |
|---|
{
"defaultApplicationScope": enum ( |
| الحقول | |
|---|---|
defaultApplicationScope |
النتائج فقط. نطاق إعداد التطبيق التلقائي غير المتوافق |
الطابع الزمني
| تمثيل JSON |
|---|
{ "seconds": string, "nanos": integer } |
| الحقول | |
|---|---|
seconds |
تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة Unix في 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين -62135596800 و253402300799 شاملةً الرقمين (وهو ما يتوافق مع 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59Z). |
nanos |
أجزاء غير سالبة من الثانية بدقة النانو ثانية هذا الحقل هو جزء من المدة بوحدة النانو ثانية، وليس بديلاً عن الثواني. يجب أن تتضمّن قيم الثواني السالبة التي تتضمّن كسورًا قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك الرقمان. |
UserFacingMessage
| تمثيل JSON |
|---|
{ "localizedMessages": { string: string, ... }, "defaultMessage": string } |
| الحقول | |
|---|---|
localizedMessages |
خريطة تحتوي على أزواج <locale, message>، حيث locale هو رمز لغة BCP 47 منسّق بشكل جيد، مثل en-US أو es-ES أو fr. عنصر يحتوي على قائمة بأزواج |
defaultMessage |
الرسالة التلقائية التي يتم عرضها في حال عدم تحديد أي رسالة مترجمة أو إذا كان المكان الجغرافي للمستخدم لا يتطابق مع أي من الرسائل المترجمة يجب تقديم رسالة تلقائية في حال تقديم أي رسائل مترجمة. |
LocalizedMessagesEntry
| تمثيل JSON |
|---|
{ "key": string, "value": string } |
| الحقول | |
|---|---|
key |
|
value |
|
SoftwareInfo
| تمثيل JSON |
|---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
| الحقول | |
|---|---|
androidVersion |
سلسلة إصدار Android المرئية للمستخدم مثلاً: |
androidDevicePolicyVersionCode |
رمز إصدار تطبيق "سياسة Android للأجهزة" |
androidDevicePolicyVersionName |
إصدار تطبيق "سياسة أمان Android" كما يظهر للمستخدم |
androidBuildNumber |
سلسلة معرّف إصدار Android مخصّصة للعرض للمستخدم. مثلاً: |
deviceKernelVersion |
إصدار النواة، مثل |
bootloaderVersion |
رقم إصدار برنامج الإقلاع على النظام، مثل |
androidBuildTime |
مدة الإنشاء يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
securityPatchLevel |
مستوى رمز تصحيح الأمان، مثل |
primaryLanguageCode |
رمز لغة IETF BCP 47 للغة الأساسية على الجهاز |
deviceBuildSignature |
تجزئة SHA-256 لـ |
systemUpdateInfo |
معلومات حول تحديث محتمل للنظام في انتظار المراجعة |
SystemUpdateInfo
| تمثيل JSON |
|---|
{
"updateStatus": enum ( |
| الحقول | |
|---|---|
updateStatus |
حالة التحديث: ما إذا كان هناك تحديث ونوعه |
updateReceivedTime |
الوقت الذي أصبح فيه التحديث متاحًا لأول مرة تشير القيمة صفر إلى أنّ هذا الحقل لم يتم ضبطه. يتم ضبط هذا الحقل فقط في حال توفّر تحديث (أي أنّ قيمة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
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 ( |
| الحقول | |
|---|---|
brand |
تمثّل هذه السمة العلامة التجارية للجهاز. مثلاً: |
hardware |
اسم الجهاز مثلاً: |
deviceBasebandVersion |
إصدار النطاق الأساسي مثلاً: |
manufacturer |
الشركة المصنّعة مثلاً: |
serialNumber |
الرقم التسلسلي للجهاز ومع ذلك، بالنسبة إلى الأجهزة الشخصية التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأحدث، يكون هذا الإعداد هو نفسه |
model |
طراز الجهاز مثلاً: |
batteryShutdownTemperatures[] |
يشير إلى الحدود الدنيا لدرجة الحرارة التي يتم عندها إيقاف تشغيل البطارية بالدرجة المئوية لكل بطارية على الجهاز. |
batteryThrottlingTemperatures[] |
يشير إلى حدود درجة الحرارة بالدرجة المئوية لكل بطارية في الجهاز التي تؤدي إلى خفض أداء البطارية. |
cpuShutdownTemperatures[] |
يشير إلى الحدود الدنيا لدرجة حرارة إيقاف وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز. |
cpuThrottlingTemperatures[] |
يشير إلى الحدود القصوى لدرجة حرارة تقييد وحدة المعالجة المركزية (CPU) بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز. |
gpuShutdownTemperatures[] |
يشير إلى حدود إيقاف تشغيل وحدة معالجة الرسومات بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز. |
gpuThrottlingTemperatures[] |
يشير إلى الحدود الدنيا لدرجة حرارة تقييد وحدة معالجة الرسومات (GPU) بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز. |
skinShutdownTemperatures[] |
الحدود القصوى لدرجة حرارة سطح الجهاز التي تؤدي إلى إيقافه، وذلك بالدرجة المئوية. |
skinThrottlingTemperatures[] |
عتبات درجة حرارة خفض سرعة وحدة المعالجة المركزية (CPU) لجلد الجهاز بالدرجة المئوية |
enterpriseSpecificId |
النتائج فقط. معرّف يحدّد بشكل فريد جهازًا مملوكًا شخصيًا في مؤسسة معيّنة. على الجهاز الفعلي نفسه عند التسجيل في المؤسسة نفسها، يظلّ هذا المعرّف ثابتًا في عمليات الإعداد وحتى في عمليات إعادة الضبط على الإعدادات الأصلية. يتوفّر رقم التعريف هذا على الأجهزة الشخصية التي تتضمّن ملف عمل على الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأحدث. |
euiccChipInfo[] |
النتائج فقط. معلومات ذات صلة بشريحة eUICC |
EuiccChipInfo
| تمثيل JSON |
|---|
{ "eid": string } |
| الحقول | |
|---|---|
eid |
النتائج فقط. مستند الهوية المضمّن (EID) الذي يحدّد شريحة eUICC لكل شريحة eUICC على الجهاز تتوفّر هذه الميزة على الأجهزة المملوكة للشركة والتي تعمل بالإصدار 13 من نظام التشغيل Android والإصدارات الأحدث. |
الشبكة الإعلانية
| تمثيل JSON |
|---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
| الحقول | |
|---|---|
name |
اسم الشاشة |
displayId |
معرّف العرض الفريد |
refreshRate |
معدّل تحديث الشاشة باللقطات في الثانية |
state |
حالة الشاشة |
width |
عرض الشاشة بالبكسل. |
height |
تمثّل هذه السمة ارتفاع الشاشة بالبكسل. |
density |
تمثّل هذه السمة كثافة العرض معبّرًا عنها بالنقاط في البوصة. |
ApplicationReport
| تمثيل JSON |
|---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
| الحقول | |
|---|---|
packageName |
اسم حزمة التطبيق |
versionName |
تمثّل هذه السمة إصدار التطبيق كما يظهر للمستخدم. |
versionCode |
رمز إصدار التطبيق، الذي يمكن استخدامه لتحديد ما إذا كان أحد الإصدارات أحدث من إصدار آخر. |
events[] |
قائمة بأحداث التطبيق التي حدثت في آخر 30 ساعة |
displayName |
الاسم المعروض للتطبيق |
packageSha256Hash |
تجزئة SHA-256 لملف APK الخاص بالتطبيق، والتي يمكن استخدامها للتحقّق من عدم تعديل التطبيق يتم تمثيل كل بايت من قيمة التجزئة كرقم سداسي عشري مكوّن من رقمين. |
signingKeyCertFingerprints[] |
تجزئة SHA-1 لكل |
installerPackageName |
اسم حزمة التطبيق الذي ثبّت هذا التطبيق |
applicationSource |
مصدر الحزمة |
state |
حالة التطبيق |
keyedAppStates[] |
قائمة بحالات التطبيق التي تم إدخال مفتاح لها والتي أبلغ عنها التطبيق. |
userFacingType |
تُستخدَم لتحديد ما إذا كان التطبيق موجّهًا للمستخدمين. |
ApplicationEvent
| تمثيل JSON |
|---|
{
"eventType": enum ( |
| الحقول | |
|---|---|
eventType |
نوع حدث التطبيق |
createTime |
تمثّل هذه السمة وقت إنشاء الحدث. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
KeyedAppState
| تمثيل JSON |
|---|
{
"key": string,
"severity": enum ( |
| الحقول | |
|---|---|
key |
مفتاح حالة التطبيق. يعمل كمرجع لما يوفّره التطبيق من حالة. على سبيل المثال، عند تقديم ملاحظات حول الإعدادات المُدارة، يمكن أن يكون هذا المفتاح هو مفتاح الإعدادات المُدارة. |
severity |
تمثّل هذه السمة مستوى خطورة حالة التطبيق. |
message |
سلسلة رسائل ذات تنسيق حر لشرح حالة التطبيق (اختيارية). إذا تم تفعيل الحالة بواسطة قيمة معيّنة (مثل قيمة إعداد مُدار)، يجب تضمينها في الرسالة. |
data |
قيمة اختيارية يمكن أن يقرأها نظام إدارة الخدمات الجوّالة للمؤسسات (EMM). على سبيل المثال، ضبط القيم التي يمكن للمشرف اختيار طلب البحث عنها في وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM) (مثل "إرسال إشعار إليّ إذا كانت بيانات battery_warning < 10"). |
createTime |
وقت إنشاء حالة التطبيق على الجهاز. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
lastUpdateTime |
الوقت الذي تم فيه تعديل حالة التطبيق مؤخرًا يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
NetworkInfo
| تمثيل JSON |
|---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
| الحقول | |
|---|---|
imei |
رقم IMEI لجهاز GSM مثلاً: |
meid |
رقم تعريف الأجهزة الجوّالة (MEID) لجهاز CDMA مثلاً: |
wifiMacAddress |
عنوان MAC لشبكة Wi-Fi للجهاز مثلاً: |
networkOperatorName |
الاسم الأبجدي للمشغّل المسجّل الحالي على سبيل المثال، Vodafone. |
telephonyInfos[] |
توفّر هذه السمة معلومات الاتصال المرتبطة بكل شريحة SIM على الجهاز. لا تتوفّر إلا على الأجهزة المُدارة بالكامل التي تعمل بالإصدار 23 من واجهة برمجة التطبيقات لنظام التشغيل Android والإصدارات الأحدث. |
TelephonyInfo
| تمثيل JSON |
|---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
| الحقول | |
|---|---|
phoneNumber |
رقم الهاتف المرتبط بشريحة SIM هذه |
carrierName |
اسم مشغّل شبكة الجوّال المرتبط بشريحة SIM هذه |
iccId |
النتائج فقط. رقم ICCID المرتبط بشريحة SIM هذه |
activationState |
النتائج فقط. حالة تفعيل شريحة SIM على الجهاز ينطبق ذلك على شرائح eSIM فقط. تتوفّر هذه الميزة على جميع الأجهزة التي تعمل بالمستوى 35 لواجهة برمجة التطبيقات والإصدارات الأحدث. تكون هذه القيمة دائمًا |
configMode |
النتائج فقط. وضع إعدادات شريحة SIM على الجهاز ينطبق ذلك على شرائح eSIM فقط. تتوفّر هذه الميزة على جميع الأجهزة التي تعمل بالمستوى 35 لواجهة برمجة التطبيقات والإصدارات الأحدث. تكون هذه القيمة دائمًا |
MemoryInfo
| تمثيل JSON |
|---|
{ "totalRam": string, "totalInternalStorage": string } |
| الحقول | |
|---|---|
totalRam |
إجمالي سعة ذاكرة الوصول العشوائي (RAM) على الجهاز بالبايت |
totalInternalStorage |
إجمالي مساحة التخزين الداخلية على الجهاز بالبايت |
MemoryEvent
| تمثيل JSON |
|---|
{
"eventType": enum ( |
| الحقول | |
|---|---|
eventType |
نوع الحدث. |
createTime |
تمثّل هذه السمة وقت إنشاء الحدث. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
byteCount |
عدد وحدات البايت المجانية في الوسيط، أو بالنسبة إلى |
PowerManagementEvent
| تمثيل JSON |
|---|
{
"eventType": enum ( |
| الحقول | |
|---|---|
eventType |
نوع الحدث. |
createTime |
تمثّل هذه السمة وقت إنشاء الحدث. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
batteryLevel |
بالنسبة إلى أحداث |
HardwareStatus
| تمثيل JSON |
|---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
| الحقول | |
|---|---|
createTime |
الوقت الذي تم فيه أخذ القياسات يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
batteryTemperatures[] |
درجات حرارة البطارية الحالية بالدرجة المئوية لكل بطارية على الجهاز |
cpuTemperatures[] |
درجات حرارة وحدة المعالجة المركزية الحالية بالدرجة المئوية لكل وحدة معالجة مركزية على الجهاز |
gpuTemperatures[] |
درجات حرارة وحدة معالجة الرسومات الحالية بالدرجة المئوية لكل وحدة معالجة رسومات على الجهاز |
skinTemperatures[] |
درجات حرارة سطح الجهاز الحالية بالدرجة المئوية |
fanSpeeds[] |
سرعات المراوح في الدقيقة لكل مروحة على الجهاز تعني المصفوفة الفارغة أنّه لا توجد مراوح أو أنّ سرعة المروحة غير متاحة على النظام. |
cpuUsages[] |
استخدامات وحدة المعالجة المركزية (CPU) بالنسبة المئوية لكل نواة متاحة على الجهاز يكون الاستخدام 0 لكل نواة غير موصولة. يشير المصفوفة الفارغة إلى أنّ استخدام وحدة المعالجة المركزية غير متاح في النظام. |
DeviceSettings
| تمثيل JSON |
|---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
| الحقول | |
|---|---|
isDeviceSecure |
تحديد ما إذا كان الجهاز محميًا برقم تعريف شخصي أو كلمة مرور |
unknownSourcesEnabled |
تُستخدَم لتحديد ما إذا كان مسموحًا بتثبيت التطبيقات من مصادر غير معروفة. |
developmentSettingsEnabled |
تحديد ما إذا كان "وضع المطوّر" مفعَّلاً على الجهاز |
adbEnabled |
تحديد ما إذا كان تصحيح أخطاء Android مفعَّلاً على الجهاز |
isEncrypted |
تُستخدَم لتحديد ما إذا كان تشفير مساحة التخزين مفعَّلاً. |
encryptionStatus |
حالة التشفير من DevicePolicyManager |
verifyAppsEnabled |
تحديد ما إذا كان سيتم فرض التحقّق من Google Play للحماية على الجهاز |
المستخدم
| تمثيل JSON |
|---|
{ "accountIdentifier": string } |
| الحقول | |
|---|---|
accountIdentifier |
معرّف فريد تنشئه لهذا المستخدم، مثل |
SystemPropertiesEntry
| تمثيل JSON |
|---|
{ "key": string, "value": string } |
| الحقول | |
|---|---|
key |
|
value |
|
SecurityPosture
| تمثيل JSON |
|---|
{ "devicePosture": enum ( |
| الحقول | |
|---|---|
devicePosture |
قيمة وضع أمان الجهاز |
postureDetails[] |
تفاصيل إضافية حول مستوى أمان الجهاز. |
PostureDetail
| تمثيل JSON |
|---|
{ "securityRisk": enum ( |
| الحقول | |
|---|---|
securityRisk |
خطر أمني محدّد يؤثّر سلبًا في مستوى أمان الجهاز. |
advice[] |
نصائح موجّهة إلى المشرفين للحدّ من هذا الخطر الأمني وتحسين مستوى أمان الجهاز |
CommonCriteriaModeInfo
| تمثيل JSON |
|---|
{ "commonCriteriaModeStatus": enum ( |
| الحقول | |
|---|---|
commonCriteriaModeStatus |
تحدّد هذه السمة ما إذا كان "وضع المعايير المشتركة" مفعَّلاً. |
policySignatureVerificationStatus |
النتائج فقط. حالة إثبات صحة توقيع السياسة |
PasswordRequirements
| تمثيل JSON |
|---|
{ "passwordMinimumLength": integer, "passwordMinimumLetters": integer, "passwordMinimumLowerCase": integer, "passwordMinimumNonLetter": integer, "passwordMinimumNumeric": integer, "passwordMinimumSymbols": integer, "passwordMinimumUpperCase": integer, "passwordQuality": enum ( |
| الحقول | |
|---|---|
passwordMinimumLength |
الحد الأدنى المسموح به لطول كلمة المرور تشير القيمة 0 إلى عدم وجود قيود. لا يتم تطبيقها إلا عندما تكون قيمة |
passwordMinimumLetters |
الحد الأدنى لعدد الأحرف المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordMinimumLowerCase |
الحد الأدنى لعدد الأحرف الصغيرة المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordMinimumNonLetter |
الحد الأدنى لعدد الأحرف غير الأبجدية (الأرقام أو الرموز) المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordMinimumNumeric |
الحد الأدنى لعدد الأرقام المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordMinimumSymbols |
الحد الأدنى لعدد الرموز المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordMinimumUpperCase |
الحد الأدنى لعدد الأحرف الكبيرة المطلوبة في كلمة المرور لا يتم فرضها إلا عندما تكون قيمة |
passwordQuality |
جودة كلمة المرور المطلوبة |
passwordHistoryLength |
طول سجلّ كلمات المرور بعد ضبط هذا الحقل، لن يتمكّن المستخدم من إدخال كلمة مرور جديدة مطابقة لأي كلمة مرور في السجلّ. تشير القيمة 0 إلى عدم وجود قيود. |
maximumFailedPasswordsForWipe |
عدد كلمات المرور غير الصحيحة لفتح قفل الجهاز التي يمكن إدخالها قبل حجب بيانات الجهاز تشير القيمة 0 إلى عدم وجود قيود. |
passwordExpirationTimeout |
مهلة انتهاء صلاحية كلمة المرور مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
passwordScope |
النطاق الذي ينطبق عليه شرط كلمة المرور |
requirePasswordUnlock |
هي المدة الزمنية التي يمكن خلالها فتح قفل الجهاز أو ملف العمل باستخدام أي طريقة مصادقة أخرى (مثل بصمة الإصبع أو وكلاء موثوق بهم أو الوجه) بعد فتح قفله باستخدام طريقة مصادقة قوية (كلمة المرور أو رقم التعريف الشخصي أو النقش). بعد انقضاء الفترة الزمنية المحدّدة، لا يمكن استخدام سوى أشكال المصادقة القوية لفتح قفل الجهاز أو ملف العمل. |
unifiedLockSettings |
يتحكّم هذا الإعداد في ما إذا كان مسموحًا بقفل موحّد للجهاز وملف العمل على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأحدث والتي تتضمّن ملف عمل. لا يمكن ضبط هذا الخيار إلا إذا تم ضبط |
المدة
| تمثيل JSON |
|---|
{ "seconds": string, "nanos": integer } |
| الحقول | |
|---|---|
seconds |
ثوانٍ موقّعة من الفترة الزمنية يجب أن تتراوح القيمة بين -315,576,000,000 و+315,576,000,000، بما في ذلك الرقمان. ملاحظة: يتم احتساب هذه الحدود من خلال: 60 ثانية/دقيقة * 60 دقيقة/ساعة * 24 ساعة/يوم * 365.25 يوم/سنة * 10000 سنة |
nanos |
أجزاء من الثانية موقّعة بدقة النانو ثانية لمدة الفترة الزمنية. يتم تمثيل المدد الزمنية الأقل من ثانية واحدة بحقل 0 |
DpcMigrationInfo
| تمثيل JSON |
|---|
{ "previousDpc": string, "additionalData": string } |
| الحقول | |
|---|---|
previousDpc |
النتائج فقط. إذا تم نقل هذا الجهاز من أداة أخرى لإدارة سياسات الجهاز (DPC)، سيكون هذا هو اسم الحزمة. لا تتم تعبئة هذا الحقل بأي طريقة أخرى. |
additionalData |
النتائج فقط. إذا تم نقل هذا الجهاز من أداة أخرى لإدارة سياسات الجهاز (DPC)، سيتم ملء حقل |
DefaultApplicationInfo
| تمثيل JSON |
|---|
{ "defaultApplicationType": enum ( |
| الحقول | |
|---|---|
defaultApplicationType |
النتائج فقط. نوع التطبيق التلقائي |
packageName |
النتائج فقط. اسم حزمة التطبيق التلقائي الحالي |
defaultApplicationSettingAttempts[] |
النتائج فقط. تفاصيل عن محاولات ضبط التطبيق التلقائي، بالترتيب نفسه الوارد في |
DefaultApplicationSettingAttempt
| تمثيل JSON |
|---|
{
"packageName": string,
"attemptOutcome": enum ( |
| الحقول | |
|---|---|
packageName |
النتائج فقط. اسم حزمة التطبيق الذي تمت محاولة استخدامه. |
attemptOutcome |
النتائج فقط. نتيجة ضبط التطبيق كتطبيق تلقائي |
التعليقات التوضيحية للأدوات
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌