MCP Tools Reference: Android Device Management MCP Server

ابزار: list_devices

دستگاه‌های یک شرکت مشخص را فهرست می‌کند. به شناسه شرکت در فیلد والد نیاز دارد (مثلاً enterprises/{enterpriseId}).

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار list_devices MCP را نشان می‌دهد.

درخواست کرل 
                  
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
}'

طرحواره ورودی

درخواست فهرست کردن دستگاه‌های یک شرکت خاص.

درخواست لیست دستگاه‌ها

نمایش JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
فیلدها
parent

string

نام شرکت به شکل enterprises/{enterpriseId} .

pageSize

integer

اندازه صفحه درخواستی. اگر مشخص نشود، حداکثر 10 دستگاه بازگردانده می‌شود. حداکثر مقدار 100 است؛ مقادیر بالاتر از 100 به 100 محدود می‌شوند. این محدودیت‌ها می‌توانند با گذشت زمان تغییر کنند.

pageToken

string

یک توکن که صفحه‌ای از نتایج برگردانده شده توسط سرور را مشخص می‌کند.

طرحواره خروجی

پاسخ به درخواست فهرست کردن دستگاه‌های یک شرکت معین.

پاسخ ListDevices

نمایش 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 Device Policy روی دستگاه اتخاذ می‌کند. این موضوع بر تنظیمات سیاست پشتیبانی‌شده تأثیر می‌گذارد.

state

enum ( DeviceState )

وضعیتی که قرار است به دستگاه اعمال شود. این فیلد را می‌توان با درخواست وصله تغییر داد. توجه داشته باشید که هنگام فراخوانی enterprises.devices.patch ، ACTIVE و DISABLED تنها مقادیر مجاز هستند. برای وارد کردن دستگاه به حالت DELETED ، enterprises.devices.delete را فراخوانی کنید.

appliedState

enum ( DeviceState )

وضعیتی که در حال حاضر برای دستگاه اعمال می‌شود.

policyCompliant

boolean

اینکه آیا دستگاه با خط‌مشی خود مطابقت دارد یا خیر.

nonComplianceDetails[]

object ( NonComplianceDetail )

جزئیات مربوط به تنظیمات خط‌مشی که دستگاه با آنها سازگار نیست.

enrollmentTime

string ( Timestamp format)

زمان ثبت نام دستگاه

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 برای کاربر دستگاه اعمال می‌شود. این فیلد را می‌توان با درخواست وصله اصلاح کرد. می‌توانید هنگام فراخوانی enterprises.devices.patch ، فقط policyId مشخص کنید، البته تا زمانی که policyId حاوی هیچ اسلشی نباشد. بقیه نام سیاست استنباط می‌شود.

appliedPolicyName

string

نام خط‌مشی‌ای که در حال حاضر روی دستگاه اعمال شده است.

appliedPolicyVersion

string ( int64 format)

نسخه خط‌مشی که در حال حاضر روی دستگاه اعمال می‌شود.

apiLevel

integer

سطح API نسخه پلتفرم اندروید که روی دستگاه اجرا می‌شود.

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 در خط‌مشی دستگاه مقدار true داشته باشد.

previousDeviceNames[]

string

اگر یک دستگاه فیزیکی چندین بار ثبت شده باشد، این فیلد شامل نام دستگاه‌های قبلی آن است. شماره سریال به عنوان شناسه منحصر به فرد برای تعیین اینکه آیا همان دستگاه فیزیکی قبلاً ثبت شده است یا خیر، استفاده می‌شود. نام‌ها به ترتیب زمانی هستند.

networkInfo

object ( NetworkInfo )

اطلاعات شبکه دستگاه. این اطلاعات فقط در صورتی در دسترس است که networkInfoEnabled در خط‌مشی دستگاه مقدار true داشته باشد.

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 در خط‌مشی دستگاه مقدار true داشته باشد.

یک شیء شامل لیستی از جفت‌های "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 در خط‌مشی دستگاه صحیح باشد. در اندروید ۱۶ و بالاتر موجود است.

همه انواع برنامه‌ها در دستگاه‌های کاملاً مدیریت‌شده گزارش می‌شوند. انواع DEFAULT_BROWSER ، DEFAULT_CALL_REDIRECTION ، DEFAULT_CALL_SCREENING و DEFAULT_DIALER برای پروفایل‌های کاری در دستگاه‌های متعلق به شرکت با پروفایل کاری و دستگاه‌های متعلق به شخصی گزارش می‌شوند. DEFAULT_WALLET نیز برای دستگاه‌های متعلق به شرکت با پروفایل کاری گزارش می‌شود، اما فقط شامل اطلاعات پروفایل کاری خواهد بود.

جزئیات عدم انطباق

نمایش 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 سیاست در جاوا اسکریپت به آن ارجاع داده می‌شود، یعنی: ۱) برای فیلدهای نوع شیء، نام فیلد با یک نقطه و سپس نام یک زیرفیلد دنبال می‌شود. ۲) برای فیلدهای نوع آرایه، نام فیلد با اندیس آرایه که در داخل براکت قرار دارد، دنبال می‌شود. به عنوان مثال، برای نشان دادن مشکل در فیلد 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.
}
فیلدها
فیلد Union kind . نوع مقدار. kind فقط می‌تواند یکی از موارد زیر باشد:
nullValue

null

نشان دهنده مقدار تهی (null) است.

numberValue

number

نشان دهنده یک مقدار مضاعف است.

stringValue

string

نشان دهنده یک مقدار رشته ای است.

boolValue

boolean

نشان دهنده یک مقدار بولی است.

structValue

object ( Struct format)

نشان دهنده یک مقدار ساختار یافته است.

listValue

array ( ListValue format)

نشان دهنده یک Value تکراری است.

ساختار

نمایش JSON 
{
  "fields": {
    string: value,
    ...
  }
}
فیلدها
fields

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

نقشه نامرتب از مقادیر با نوع پویا.

یک شیء شامل لیستی از جفت‌های "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

فیلدهاورود

نمایش JSON 
{
  "key": string,
  "value": value
}
فیلدها
key

string

value

value ( Value format)

مقدار لیست

نمایش JSON 
{
  "values": [
    value
  ]
}
فیلدها
values[]

value ( Value format)

فیلد تکراری با مقادیر تایپ‌شده‌ی پویا.

عدم انطباق خاص

نمایش 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 ناسازگار.

سیاست‌های رمز عبور

نمایش JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
فیلدها
passwordPolicyScope

enum ( PasswordPolicyScope )

دامنه رمز عبور غیر منطبق.

پیش‌فرضبرنامهزمینه

نمایش JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
فیلدها
defaultApplicationScope

enum ( DefaultApplicationScope )

فقط خروجی. محدوده تنظیمات پیش‌فرض برنامه که با استانداردها مطابقت ندارد.

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

کاربرFacingMessage

نمایش 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

اطلاعات نرم‌افزار

نمایش 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

رشته‌ی نسخه اندروید که توسط کاربر قابل مشاهده است. برای مثال، 6.0.1 .

androidDevicePolicyVersionCode

integer

کد نسخه برنامه خط‌مشی دستگاه اندروید.

androidDevicePolicyVersionName

string

نسخه برنامه Android Device Policy همانطور که به کاربر نمایش داده می‌شود.

androidBuildNumber

string

رشته شناسه ساخت اندروید که برای نمایش به کاربر در نظر گرفته شده است. برای مثال، 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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

اطلاعات مربوط به به‌روزرسانی احتمالی سیستم در انتظار.

اطلاعات به‌روزرسانی سیستم

نمایش JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
فیلدها
updateStatus

enum ( UpdateStatus )

وضعیت به‌روزرسانی: آیا به‌روزرسانی وجود دارد و از چه نوعی است.

updateReceivedTime

string ( Timestamp format)

زمانی که به‌روزرسانی برای اولین بار در دسترس بوده است. مقدار صفر نشان می‌دهد که این فیلد تنظیم نشده است. این فیلد فقط در صورتی تنظیم می‌شود که به‌روزرسانی در دسترس باشد (یعنی updateStatus نه UPDATE_STATUS_UNKNOWN است و نه UP_TO_DATE ).

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

اطلاعات سخت‌افزاری

نمایش 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

شماره سریال دستگاه. با این حال، برای دستگاه‌های شخصی که اندروید ۱۲ و بالاتر را اجرا می‌کنند، این همان enterpriseSpecificId است.

model

string

مدل دستگاه. به عنوان مثال، Asus Nexus 7 .

batteryShutdownTemperatures[]

number

آستانه‌های دمای خاموش شدن باتری بر حسب سانتیگراد برای هر باتری روی دستگاه.

batteryThrottlingTemperatures[]

number

آستانه‌های دمای تنظیم دمای باتری بر حسب سانتیگراد برای هر باتری روی دستگاه.

cpuShutdownTemperatures[]

number

آستانه‌های دمای خاموش شدن پردازنده بر حسب سانتیگراد برای هر پردازنده روی دستگاه.

cpuThrottlingTemperatures[]

number

آستانه‌های دمای تنظیم گلوگاه پردازنده بر حسب سانتیگراد برای هر پردازنده روی دستگاه.

gpuShutdownTemperatures[]

number

آستانه‌های دمای خاموش شدن پردازنده گرافیکی (GPU) بر حسب سانتیگراد برای هر پردازنده گرافیکی روی دستگاه.

gpuThrottlingTemperatures[]

number

آستانه‌های دمای گلوگاه پردازنده گرافیکی (GPU) بر حسب سانتیگراد برای هر پردازنده گرافیکی روی دستگاه.

skinShutdownTemperatures[]

number

آستانه‌های دمای خاموش شدن پوسته دستگاه بر حسب سانتیگراد.

skinThrottlingTemperatures[]

number

آستانه‌های دمایی تنظیم‌کننده‌ی دمای پوست دستگاه بر حسب سانتیگراد.

enterpriseSpecificId

string

فقط خروجی. شناسه‌ای که به‌طور منحصربه‌فرد یک دستگاه شخصی را در یک سازمان خاص شناسایی می‌کند. در همان دستگاه فیزیکی، هنگام ثبت‌نام در همان سازمان، این شناسه در طول تنظیمات و حتی بازنشانی به تنظیمات کارخانه باقی می‌ماند. این شناسه در دستگاه‌های شخصی با نمایه کاری در دستگاه‌های دارای اندروید ۱۲ و بالاتر موجود است.

euiccChipInfo[]

object ( EuiccChipInfo )

فقط خروجی. اطلاعات مربوط به تراشه eUICC.

اطلاعات تراشه Euicc

نمایش JSON 
{
  "eid": string
}
فیلدها
eid

string

فقط خروجی. سند هویت تعبیه‌شده (EID) که تراشه eUICC را برای هر تراشه eUICC روی دستگاه شناسایی می‌کند. این سند در دستگاه‌های متعلق به شرکت که اندروید ۱۳ و بالاتر دارند، موجود است.

نمایش

نمایش 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

تراکم نمایشگر که بر حسب نقطه در هر اینچ بیان می‌شود.

گزارش برنامه

نمایش 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 )

اینکه آیا برنامه با کاربر روبرو است یا خیر.

رویداد برنامه

نمایش JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
فیلدها
eventType

enum ( ApplicationEventType )

نوع رویداد برنامه

createTime

string ( Timestamp format)

زمان ایجاد رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

حالت برنامه کلیددار

نمایش 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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

اطلاعات شبکه

نمایش JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
فیلدها
imei

string

شماره IMEI دستگاه GSM. به عنوان مثال، A1000031212 .

meid

string

شماره MEID دستگاه CDMA. برای مثال، A00000292788E1 .

wifiMacAddress

string

آدرس مک وای‌فای دستگاه. برای مثال، 7c:11:11:11:11:11 .

networkOperatorName
(deprecated)

string

نام الفبایی اپراتور ثبت‌شده فعلی. برای مثال، وودافون.

telephonyInfos[]

object ( TelephonyInfo )

اطلاعات تلفنی مرتبط با هر سیم‌کارت روی دستگاه را ارائه می‌دهد. فقط در دستگاه‌های کاملاً مدیریت‌شده از سطح ۲۳ رابط برنامه‌نویسی اندروید پشتیبانی می‌شود.

اطلاعات تلفنی

نمایش JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
فیلدها
phoneNumber

string

شماره تلفنی که به این سیم کارت متصل است.

carrierName

string

نام اپراتور مرتبط با این سیم کارت.

iccId

string

فقط خروجی. ICCID مرتبط با این سیم کارت.

activationState

enum ( ActivationState )

فقط خروجی. وضعیت فعال بودن سیم‌کارت روی دستگاه. این مورد فقط برای eSIMها قابل استفاده است. این مورد در همه دستگاه‌های دارای API سطح ۳۵ و بالاتر پشتیبانی می‌شود. این مورد برای سیم‌کارت‌های فیزیکی و دستگاه‌های پایین‌تر از API سطح ۳۵، همیشه ACTIVATION_STATE_UNSPECIFIED است.

configMode

enum ( ConfigMode )

فقط خروجی. حالت پیکربندی سیم‌کارت روی دستگاه. این فقط برای eSIMها قابل استفاده است. این در همه دستگاه‌های دارای API سطح ۳۵ و بالاتر پشتیبانی می‌شود. این مقدار برای سیم‌کارت‌های فیزیکی و دستگاه‌های پایین‌تر از API سطح ۳۵ همیشه CONFIG_MODE_UNSPECIFIED است.

اطلاعات حافظه

نمایش JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
فیلدها
totalRam

string ( int64 format)

کل رم موجود در دستگاه بر حسب بایت.

totalInternalStorage

string ( int64 format)

کل حافظه داخلی دستگاه بر حسب بایت.

رویداد حافظه

نمایش JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
فیلدها
eventType

enum ( MemoryEventType )

نوع رویداد.

createTime

string ( Timestamp format)

زمان ایجاد رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 ، کل ظرفیت رسانه ذخیره‌سازی بر حسب بایت.

رویداد مدیریت توان

نمایش JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
فیلدها
eventType

enum ( PowerManagementEventType )

نوع رویداد.

createTime

string ( Timestamp format)

زمان ایجاد رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

batteryLevel

number

برای رویدادهای BATTERY_LEVEL_COLLECTED ، میزان باتری به صورت درصد.

وضعیت سخت‌افزار

نمایش JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
فیلدها
createTime

string ( Timestamp format)

زمانی که اندازه‌گیری‌ها انجام شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

batteryTemperatures[]

number

دمای فعلی باتری بر حسب سانتیگراد برای هر باتری روی دستگاه.

cpuTemperatures[]

number

دمای فعلی CPU بر حسب سانتیگراد برای هر CPU روی دستگاه.

gpuTemperatures[]

number

دمای فعلی پردازنده گرافیکی (GPU) بر حسب سانتیگراد برای هر پردازنده گرافیکی روی دستگاه.

skinTemperatures[]

number

دمای فعلی پوست دستگاه بر حسب سانتیگراد.

fanSpeeds[]

number

سرعت فن‌ها بر حسب RPM برای هر فن روی دستگاه. آرایه خالی به این معنی است که هیچ فن وجود ندارد یا سرعت فن روی سیستم پشتیبانی نمی‌شود.

cpuUsages[]

number

درصد استفاده از CPU برای هر هسته موجود در دستگاه. میزان استفاده برای هر هسته جدا شده 0 است. آرایه خالی به این معنی است که استفاده از CPU در سیستم پشتیبانی نمی‌شود.

تنظیمات دستگاه

نمایش 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 Protect روی دستگاه اعمال می‌شود یا خیر.

کاربر

نمایش JSON 
{
  "accountIdentifier": string
}
فیلدها
accountIdentifier

string

یک شناسه منحصر به فرد که برای این کاربر ایجاد می‌کنید، مانند user342 یا asset#44418 . این فیلد باید هنگام ایجاد کاربر تنظیم شود و قابل به‌روزرسانی نیست. این فیلد نباید حاوی اطلاعات شخصی قابل شناسایی (PII) باشد. این شناسه باید 1024 کاراکتر یا کمتر باشد. در غیر این صورت، درخواست به‌روزرسانی خط‌مشی با شکست مواجه خواهد شد.

ورودی ویژگی‌های سیستم

نمایش JSON 
{
  "key": string,
  "value": string
}
فیلدها
key

string

value

string

وضعیت امنیتی

نمایش JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
فیلدها
devicePosture

enum ( DevicePosture )

مقدار وضعیت امنیتی دستگاه.

postureDetails[]

object ( PostureDetail )

جزئیات بیشتر در مورد وضعیت امنیتی دستگاه.

جزئیات وضعیت

نمایش JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
فیلدها
securityRisk

enum ( SecurityRisk )

یک خطر امنیتی خاص که بر وضعیت امنیتی دستگاه تأثیر منفی می‌گذارد.

advice[]

object ( UserFacingMessage )

توصیه‌های مربوطه در مواجهه با مدیر برای کاهش این خطر امنیتی و بهبود وضعیت امنیتی دستگاه.

اطلاعات حالت معیارهای مشترک

نمایش JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
فیلدها
commonCriteriaModeStatus

enum ( CommonCriteriaModeStatus )

آیا حالت معیارهای مشترک فعال است یا خیر.

policySignatureVerificationStatus

enum ( PolicySignatureVerificationStatus )

فقط خروجی. وضعیت تأیید امضای سیاست.

الزامات رمز عبور

نمایش 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

طول تاریخچه رمز عبور. پس از تنظیم این فیلد، کاربر نمی‌تواند رمز عبور جدیدی را وارد کند که مشابه هیچ رمز عبوری در تاریخچه باشد. مقدار ۰ به این معنی است که هیچ محدودیتی وجود ندارد.

maximumFailedPasswordsForWipe

integer

تعداد رمزهای عبور نادرست برای باز کردن قفل دستگاه که می‌توان قبل از پاک کردن اطلاعات دستگاه وارد کرد. مقدار ۰ به این معنی است که هیچ محدودیتی وجود ندارد.

passwordExpirationTimeout

string ( Duration format)

مهلت انقضای رمز عبور به پایان رسیده است.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

passwordScope

enum ( PasswordPolicyScope )

محدوده‌ای که الزام رمز عبور در آن اعمال می‌شود.

requirePasswordUnlock

enum ( RequirePasswordUnlock )

مدت زمانی که پس از باز شدن قفل دستگاه یا پروفایل کاری با استفاده از یک روش احراز هویت قوی (رمز عبور، پین، الگو) می‌توان آن را با استفاده از هر روش احراز هویت دیگری (مثلاً اثر انگشت، عوامل معتمد، چهره) باز کرد. پس از گذشت مدت زمان مشخص شده، فقط می‌توان از روش‌های احراز هویت قوی برای باز کردن قفل دستگاه یا پروفایل کاری استفاده کرد.

unifiedLockSettings

enum ( UnifiedLockSettings )

کنترل می‌کند که آیا قفل یکپارچه برای دستگاه و پروفایل کاری، در دستگاه‌هایی که اندروید ۹ و بالاتر با پروفایل کاری دارند، مجاز است یا خیر. این مورد فقط در صورتی قابل تنظیم است که password_scope روی SCOPE_PROFILE تنظیم شده باشد، در غیر این صورت این خط‌مشی رد می‌شود. اگر کاربر قفل کاری جداگانه‌ای تنظیم نکرده باشد و این فیلد روی REQUIRE_SEPARATE_WORK_LOCK تنظیم شده باشد، NonComplianceDetail با nonComplianceReason تنظیم شده روی USER_ACTION گزارش می‌شود.

مدت زمان

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های علامت‌دار از بازه زمانی. باید از -۳۱۵,۵۷۶,۰۰۰,۰۰۰ تا +۳۱۵,۵۷۶,۰۰۰,۰۰۰ باشد. توجه: این محدوده‌ها از فرمول زیر محاسبه می‌شوند: ۶۰ ثانیه بر دقیقه * ۶۰ دقیقه بر ساعت * ۲۴ ساعت بر روز * ۳۶۵.۲۵ روز بر سال * ۱۰۰۰۰ سال

nanos

integer

کسرهای علامت‌دار از ثانیه با وضوح نانوثانیه از بازه زمانی. مدت زمان‌های کمتر از یک ثانیه با یک فیلد 0 seconds و یک فیلد nanos مثبت یا منفی نمایش داده می‌شوند. برای مدت زمان‌های یک ثانیه یا بیشتر، مقدار غیر صفر برای فیلد nanos باید با علامت فیلد seconds یکسان باشد. باید از -999,999,999 تا +999,999,999 باشد.

اطلاعات مهاجرت Dpc

نمایش JSON 
{
  "previousDpc": string,
  "additionalData": string
}
فیلدها
previousDpc

string

فقط خروجی. اگر این دستگاه از DPC دیگری منتقل شده باشد، این نام بسته آن است. در غیر این صورت، مقداردهی نمی‌شود.

additionalData

string

فقط خروجی. اگر این دستگاه از DPC دیگری مهاجرت کرده باشد، فیلد additionalData مربوط به توکن مهاجرت در اینجا پر می‌شود.

اطلاعات برنامه پیش‌فرض

نمایش JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
فیلدها
defaultApplicationType

enum ( DefaultApplicationType )

فقط خروجی. نوع برنامه پیش‌فرض.

packageName

string

فقط خروجی. نام بسته‌ی برنامه‌ی پیش‌فرض فعلی.

defaultApplicationSettingAttempts[]

object ( DefaultApplicationSettingAttempt )

فقط خروجی. جزئیات مربوط به تلاش‌های تنظیم پیش‌فرض برنامه، به همان ترتیبی که در defaultApplications فهرست شده‌اند.

تلاش پیش‌فرض برای تنظیم برنامه

نمایش JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
فیلدها
packageName

string

فقط خروجی. نام بسته‌ی برنامه‌ی مورد نظر.

attemptOutcome

enum ( AttemptOutcome )

فقط خروجی. نتیجه تنظیم برنامه به عنوان پیش‌فرض.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌