REST Resource: enterprises.devices

منبع: دستگاه

دستگاهی متعلق به یک شرکت. مگر اینکه خلاف آن ذکر شده باشد، همه فیلدها فقط خواندنی هستند و نمی‌توانند توسط enterprises.devices.patch تغییر داده شوند.

نمایش JSON 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  },
  "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} . در صورت عدم مشخص شدن، policyName برای کاربر دستگاه اعمال می‌شود. این فیلد را می‌توان با درخواست وصله اصلاح کرد. می‌توانید هنگام فراخوانی 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 )

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

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 نیز برای دستگاه‌های متعلق به شرکت با پروفایل کاری گزارش می‌شود، اما فقط شامل اطلاعات پروفایل کاری خواهد بود.

وضعیت دستگاه

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

انوم‌ها
DEVICE_STATE_UNSPECIFIED این مقدار مجاز نیست.
ACTIVE دستگاه فعال است.
DISABLED دستگاه غیرفعال است.
DELETED دستگاه حذف شد. این وضعیت هرگز توسط یک فراخوانی API بازگردانده نمی‌شود، اما در گزارش وضعیت نهایی، زمانی که دستگاه حذف را تأیید می‌کند، استفاده می‌شود. اگر دستگاه از طریق فراخوانی API حذف شود، این وضعیت در Pub/Sub منتشر می‌شود. اگر کاربر نمایه کاری را حذف کند یا دستگاه را مجدداً تنظیم کند، وضعیت دستگاه برای سرور ناشناخته خواهد ماند.
PROVISIONING دستگاه در حال آماده‌سازی است. دستگاه‌های تازه ثبت‌شده تا زمانی که سیاستی روی آنها اعمال نشود، در این وضعیت باقی می‌مانند.
LOST دستگاه گم شده است. این وضعیت فقط در دستگاه‌های متعلق به سازمان امکان‌پذیر است.
PREPARING_FOR_MIGRATION دستگاه در حال آماده‌سازی برای مهاجرت به رابط برنامه‌نویسی کاربردی مدیریت اندروید (Android Management API) است. برای ادامه‌ی مهاجرت، هیچ اقدام دیگری لازم نیست.
DEACTIVATED_BY_DEVICE_FINANCE این یک دستگاه تأمین مالی شده است که توسط عامل تأمین مالی "قفل" شده است. این بدان معناست که تنظیمات خط‌مشی خاصی اعمال شده است که عملکرد دستگاه را تا زمانی که دستگاه توسط عامل تأمین مالی "قفل" نشده باشد، محدود می‌کند. دستگاه به اعمال تنظیمات خط‌مشی به استثنای مواردی که توسط عامل تأمین مالی لغو شده‌اند، ادامه خواهد داد. هنگامی که دستگاه "قفل" می‌شود، وضعیت در appliedState به صورت DEACTIVATED_BY_DEVICE_FINANCE گزارش می‌شود.

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

جزئیات مربوط به عدم رعایت تنظیمات خط‌مشی را ارائه می‌دهد.

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

اگر packageName تنظیم شده باشد و دلیل عدم انطباق APP_NOT_INSTALLED یا APP_NOT_UPDATED باشد، دلیل دقیق عدم امکان نصب یا به‌روزرسانی برنامه مشخص می‌شود.

specificNonComplianceReason

enum ( SpecificNonComplianceReason )

دلیل خاص سیاست که دستگاه با تنظیمات مطابقت ندارد.

specificNonComplianceContext

object ( SpecificNonComplianceContext )

زمینه اضافی برای specificNonComplianceReason .

دلیل عدم موفقیت نصب

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

انوم‌ها
INSTALLATION_FAILURE_REASON_UNSPECIFIED این مقدار مجاز نیست.
INSTALLATION_FAILURE_REASON_UNKNOWN یک وضعیت ناشناخته مانع از نصب برنامه می‌شود. برخی از دلایل احتمالی عبارتند از: کمبود فضای ذخیره‌سازی دستگاه، اتصال شبکه دستگاه غیرقابل اعتماد، یا طولانی شدن نصب بیش از حد انتظار. نصب به صورت خودکار دوباره امتحان خواهد شد.
IN_PROGRESS نصب هنوز در حال انجام است.
NOT_FOUND برنامه در Play یافت نشد.
NOT_COMPATIBLE_WITH_DEVICE برنامه با دستگاه سازگار نیست.
NOT_APPROVED این برنامه توسط مدیر تایید نشده است.
PERMISSIONS_NOT_ACCEPTED این برنامه مجوزهای جدیدی دارد که توسط مدیر پذیرفته نشده‌اند.
NOT_AVAILABLE_IN_COUNTRY این برنامه در کشور کاربر در دسترس نیست.
NO_LICENSES_REMAINING هیچ مجوزی برای اختصاص به کاربر وجود ندارد.
NOT_ENROLLED این شرکت دیگر در Managed Google Play ثبت نشده است یا مدیر، آخرین شرایط خدمات Managed Google Play را نپذیرفته است.
USER_INVALID کاربر دیگر معتبر نیست. ممکن است کاربر حذف یا غیرفعال شده باشد.
NETWORK_ERROR_UNRELIABLE_CONNECTION

یک خطای شبکه در دستگاه کاربر مانع از موفقیت نصب شده است. این معمولاً زمانی اتفاق می‌افتد که اتصال اینترنت دستگاه ضعیف، غیرقابل دسترس یا مشکلی در پیکربندی شبکه وجود داشته باشد. لطفاً مطمئن شوید که دستگاه به اتصال کامل اینترنت در شبکه‌ای که Android Enterprise Network Requirements برآورده می‌کند، دسترسی دارد. پس از این اتفاق، نصب یا به‌روزرسانی برنامه به طور خودکار از سر گرفته می‌شود.

INSUFFICIENT_STORAGE دستگاه کاربر فضای ذخیره‌سازی کافی برای نصب برنامه ندارد. این مشکل را می‌توان با خالی کردن فضای ذخیره‌سازی دستگاه حل کرد. نصب یا به‌روزرسانی برنامه به محض اینکه دستگاه فضای ذخیره‌سازی کافی داشته باشد، به‌طور خودکار از سر گرفته می‌شود.

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

جزئیات بیشتر در مورد دلیل عدم تطابق یک دستگاه با تنظیمات خط‌مشی. مقادیر جدید می‌توانند در آینده به enum اضافه شوند.

انوم‌ها
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED دلیل عدم انطباق خاصی مشخص نشده است. فیلدهای موجود در specificNonComplianceContext تنظیم نشده‌اند.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED کاربر باید با وارد کردن قفل صفحه، اعتبارنامه را تأیید کند. فیلدهای موجود در specificNonComplianceContext تنظیم نشده‌اند. nonComplianceReason روی USER_ACTION تنظیم شده است.
PASSWORD_POLICIES_PASSWORD_EXPIRED رمز عبور دستگاه یا پروفایل منقضی شده است. passwordPoliciesContext تنظیم شده است. nonComplianceReason روی USER_ACTION تنظیم شده است.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT رمز عبور دستگاه، الزامات رمز عبور را برآورده نمی‌کند. passwordPoliciesContext تنظیم شده است. nonComplianceReason روی USER_ACTION تنظیم شده است.
ONC_WIFI_INVALID_VALUE یک مقدار نادرست در پیکربندی ONC Wi-Fi وجود دارد. fieldPath مشخص می‌کند که کدام مقدار فیلد نادرست است. oncWifiContext تنظیم شده است. nonComplianceReason روی INVALID_VALUE تنظیم شده است.
ONC_WIFI_API_LEVEL تنظیمات ONC Wi-Fi در سطح API نسخه اندروید در حال اجرا روی دستگاه پشتیبانی نمی‌شود. fieldPath مشخص می‌کند که کدام مقدار فیلد پشتیبانی نمی‌شود. oncWifiContext تنظیم شده است. nonComplianceReason روی API_LEVEL تنظیم شده است.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG شبکه وای‌فای سازمانی فاقد CA ریشه یا نام دامنه است. nonComplianceReason روی INVALID_VALUE تنظیم شده است.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK کاربر باید شبکه وای‌فای پیکربندی‌شده را به‌صورت دستی حذف کند. این فقط در پروفایل‌های کاری روی دستگاه‌های شخصی قابل اجرا است. nonComplianceReason روی USER_ACTION تنظیم شده است.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY نام مستعار جفت کلید مشخص شده از طریق فیلد ClientCertKeyPairAlias ​​در openNetworkConfiguration با کلید موجود نصب شده روی دستگاه مطابقت ندارد. nonComplianceReason روی INVALID_VALUE تنظیم شده است.
PERMISSIBLE_USAGE_RESTRICTION این تنظیم خط‌مشی محدود شده است و نمی‌توان آن را برای این پروژه Google Cloud Platform تنظیم کرد. جزئیات بیشتر (از جمله نحوه فعال‌سازی استفاده از این تنظیم خط‌مشی) در خط‌مشی Permissible Usage موجود است. nonComplianceReason روی PROJECT_NOT_PERMITTED تنظیم شده است.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE حساب کاری مورد نیاز توسط تنظیمات سیاست workAccountSetupConfig دیگر بخشی از سازمان نیست. nonComplianceReason روی USER_ACTION تنظیم شده است.
NEW_ACCOUNT_NOT_IN_ENTERPRISE حساب کاری اضافه شده توسط کاربر بخشی از شرکت نیست. nonComplianceReason روی USER_ACTION تنظیم شده است.
DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES

تنظیمات پیش‌فرض برنامه روی محدوده‌هایی اعمال می‌شود که توسط حالت مدیریت پشتیبانی نمی‌شوند، حتی اگر خود حالت مدیریت برای نوع برنامه پشتیبانی شود (مثلاً، یک سیاست با نوع برنامه DEFAULT_BROWSER و لیست [ SCOPE_PERSONAL_PROFILE ] که به یک دستگاه کاملاً مدیریت‌شده ارسال می‌شود، منجر به غیرقابل اجرا بودن محدوده‌ها برای حالت مدیریت می‌شود). اگر حالت مدیریت برای نوع برنامه پشتیبانی نشود، یک NonComplianceDetail با MANAGEMENT_MODE گزارش می‌شود، بدون یک specificNonComplianceReason .

nonComplianceReason روی MANAGEMENT_MODE تنظیم شده است.

DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE تنظیمات پیش‌فرض برنامه برای یک محدوده خاص اعمال نشد. defaultApplicationContext تنظیم شده است. nonComplianceReason روی INVALID_VALUE یا APP_NOT_INSTALLED تنظیم شده است.
PRIVATE_DNS_HOST_NOT_SERVING میزبان مشخص شده برای DNS خصوصی یک نام میزبان معتبر است اما مشخص شد که یک سرور DNS خصوصی نیست. nonComplianceReason روی INVALID_VALUE تنظیم شده است.

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

زمینه اضافی برای SpecificNonComplianceReason .

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

زمینه اضافی برای عدم انطباق مربوط به پیکربندی Wi-Fi.

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

string

GUID مربوط به پیکربندی Wi-Fi ناسازگار.

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

زمینه اضافی برای عدم رعایت مربوط به سیاست‌های رمز عبور.

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

enum ( PasswordPolicyScope )

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

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

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

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

enum ( DefaultApplicationScope )

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

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

اطلاعات مربوط به نرم‌افزار دستگاه.

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

وضعیت به‌روزرسانی

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

انوم‌ها
UPDATE_STATUS_UNKNOWN مشخص نیست که آیا به‌روزرسانی سیستم در حال انتظاری وجود دارد یا خیر. این اتفاق زمانی می‌افتد که، برای مثال، سطح API دستگاه کمتر از ۲۶ باشد، یا اگر نسخه خط‌مشی دستگاه اندروید قدیمی باشد.
UP_TO_DATE هیچ به‌روزرسانی سیستمی در حال انتظاری روی دستگاه موجود نیست.
UNKNOWN_UPDATE_AVAILABLE یک به‌روزرسانی سیستمی در حال بررسی موجود است، اما نوع آن مشخص نیست.
SECURITY_UPDATE_AVAILABLE یک به‌روزرسانی امنیتی در حال بررسی در دسترس است.
OS_UPDATE_AVAILABLE یک به‌روزرسانی سیستم عامل در حال انتظار در دسترس است.

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

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

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

اطلاعات مربوط به تراشه 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

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

وضعیت نمایش

وضعیت یک نمایشگر.

انوم‌ها
DISPLAY_STATE_UNSPECIFIED این مقدار مجاز نیست.
OFF نمایشگر خاموش است.
ON نمایشگر روشن است.
DOZE نمایشگر در حالت کم مصرف چرت می‌زند
SUSPENDED نمایشگر در حالت کم مصرف و معلق در حال چرت زدن است.

گزارش برنامه

اطلاعات گزارش شده در مورد یک برنامه نصب شده.

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

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

نوعی رویداد مرتبط با اپلیکیشن.

انوم‌ها
APPLICATION_EVENT_TYPE_UNSPECIFIED این مقدار مجاز نیست.
INSTALLED برنامه نصب شد.
CHANGED برنامه تغییر کرده است، برای مثال، یک جزء فعال یا غیرفعال شده است.
DATA_CLEARED اطلاعات برنامه پاک شد.
REMOVED برنامه حذف شد.
REPLACED نسخه جدید برنامه نصب شده و جایگزین نسخه قدیمی شده است.
RESTARTED برنامه دوباره راه اندازی شد.
PINNED برنامه به پیش‌زمینه پین ​​شده بود.
UNPINNED پین برنامه برداشته شد.

منبع برنامه

منبعی که یک برنامه ارائه داده است.

انوم‌ها
APPLICATION_SOURCE_UNSPECIFIED این برنامه از یک منبع نامشخص به صورت جانبی دانلود شده است.
SYSTEM_APP_FACTORY_VERSION این یک برنامه سیستمی از ایمیج کارخانه دستگاه است.
SYSTEM_APP_UPDATED_VERSION این یک برنامه سیستمی به‌روز شده است.
INSTALLED_FROM_PLAY_STORE این برنامه از فروشگاه گوگل پلی نصب شده است.
CUSTOM این برنامه با استفاده از دستور AMAPI SDK نصب شد. همچنین ببینید: CUSTOM

وضعیت برنامه

وضعیت نصب فعلی.

انوم‌ها
APPLICATION_STATE_UNSPECIFIED وضعیت برنامه مشخص نیست
REMOVED برنامه از دستگاه حذف شد
INSTALLED برنامه روی دستگاه نصب شده است

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

وضعیت برنامه‌ی کلیدگذاری شده که توسط برنامه گزارش شده است.

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

شدت

شدت وضعیت برنامه.

انوم‌ها
SEVERITY_UNSPECIFIED سطح شدت نامشخص.
INFO سطح شدت اطلاعات
ERROR سطح شدت خطا. این سطح فقط باید برای شرایط خطای واقعی تنظیم شود که یک سازمان مدیریتی باید برای رفع آن اقدام کند.

نوع کاربری

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

انوم‌ها
USER_FACING_TYPE_UNSPECIFIED نوع مواجهه کاربر با برنامه مشخص نشده است.
NOT_USER_FACING برنامه با کاربر روبرو نیست.
USER_FACING برنامه روبروی کاربر است.

اطلاعات شبکه

اطلاعات شبکه دستگاه

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

حالت فعال‌سازی

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

انوم‌ها
ACTIVATION_STATE_UNSPECIFIED وضعیت فعال‌سازی مشخص نشده است.
ACTIVATED سیم کارت فعال شده است.
NOT_ACTIVATED سیم کارت فعال نشده است.

حالت پیکربندی

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

انوم‌ها
CONFIG_MODE_UNSPECIFIED حالت پیکربندی مشخص نشده است.
ADMIN_CONFIGURED مدیر این سیم‌کارت را پیکربندی کرده است.
USER_CONFIGURED کاربر این سیم‌کارت را پیکربندی کرده است.

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

اطلاعات مربوط به حافظه و فضای ذخیره‌سازی دستگاه.

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

string ( int64 format)

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

totalInternalStorage

string ( int64 format)

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

رویداد حافظه

رویدادی مربوط به اندازه‌گیری‌های حافظه و ذخیره‌سازی.

برای تمایز قائل شدن بین رویدادهای جدید و قدیمی، توصیه می‌کنیم از فیلد createTime استفاده کنید.

نمایش 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 ، کل ظرفیت رسانه ذخیره‌سازی بر حسب بایت.

نوع رویداد حافظه

نوع رویداد.

انوم‌ها
MEMORY_EVENT_TYPE_UNSPECIFIED نامشخص. هیچ رویدادی از این نوع نیست.
RAM_MEASURED فضای خالی در رم اندازه‌گیری شد.
INTERNAL_STORAGE_MEASURED فضای خالی در حافظه داخلی اندازه‌گیری شد.
EXTERNAL_STORAGE_DETECTED یک رسانه ذخیره‌سازی خارجی جدید شناسایی شد. تعداد بایت گزارش شده، کل ظرفیت رسانه ذخیره‌سازی است.
EXTERNAL_STORAGE_REMOVED یک رسانه ذخیره‌سازی خارجی حذف شده است. تعداد بایت گزارش شده صفر است.
EXTERNAL_STORAGE_MEASURED فضای آزاد در یک رسانه ذخیره‌سازی خارجی اندازه‌گیری شد.

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

رویدادی در حوزه مدیریت مصرف برق

نمایش 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 ، میزان باتری به صورت درصد.

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

نوع رویداد.

انوم‌ها
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED نامشخص. هیچ رویدادی از این نوع نیست.
BATTERY_LEVEL_COLLECTED سطح باتری اندازه‌گیری شد.
POWER_CONNECTED دستگاه شروع به شارژ شدن کرد.
POWER_DISCONNECTED شارژ دستگاه متوقف شد.
BATTERY_LOW دستگاه وارد حالت کم‌مصرف شد.
BATTERY_OKAY دستگاه از حالت کم‌مصرف خارج شد.
BOOT_COMPLETED دستگاه بوت شد.
SHUTDOWN دستگاه خاموش شد.

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

وضعیت سخت‌افزار. دماها را می‌توان با آستانه‌های دمایی موجود در hardwareInfo مقایسه کرد تا سلامت سخت‌افزار مشخص شود.

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

وضعیت رمزگذاری

وضعیت رمزگذاری دستگاه.

انوم‌ها
ENCRYPTION_STATUS_UNSPECIFIED نامشخص. هیچ دستگاهی نباید این نوع را داشته باشد.
UNSUPPORTED رمزگذاری توسط دستگاه پشتیبانی نمی‌شود.
INACTIVE رمزگذاری توسط دستگاه پشتیبانی می‌شود، اما در حال حاضر فعال نیست.
ACTIVATING رمزگذاری در حال حاضر فعال نیست، اما در حال فعال شدن است.
ACTIVE رمزگذاری فعال است.
ACTIVE_DEFAULT_KEY رمزگذاری فعال است، اما کاربر کلید رمزگذاری را تنظیم نکرده است.
ACTIVE_PER_USER رمزگذاری فعال است و کلید رمزگذاری به پروفایل کاربر گره خورده است.

وضعیت امنیتی

وضعیت امنیتی دستگاه، که توسط وضعیت فعلی دستگاه و سیاست‌های اعمال‌شده تعیین می‌شود.

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

enum ( DevicePosture )

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

postureDetails[]

object ( PostureDetail )

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

وضعیت دستگاه

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

انوم‌ها
POSTURE_UNSPECIFIED نامشخص. هیچ جزئیات وضعیتی برای این مقدار وضعیت وجود ندارد.
SECURE این دستگاه امن است.
AT_RISK این دستگاه ممکن است در برابر عوامل مخرب آسیب‌پذیرتر از آن چیزی باشد که برای استفاده با داده‌های شرکتی توصیه می‌شود.
POTENTIALLY_COMPROMISED این دستگاه ممکن است به خطر بیفتد و داده‌های شرکت ممکن است در دسترس افراد غیرمجاز قرار گیرد.

جزئیات وضعیت

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

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

enum ( SecurityRisk )

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

advice[]

object ( UserFacingMessage )

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

امنیتریسک

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

انوم‌ها
SECURITY_RISK_UNSPECIFIED نامشخص.
UNKNOWN_OS API یکپارچگی بازی تشخیص می‌دهد که دستگاه از یک سیستم عامل ناشناخته استفاده می‌کند (بررسی یکپارچگی اولیه موفقیت‌آمیز است اما ctsProfileMatch ناموفق است).
COMPROMISED_OS رابط برنامه‌نویسی کاربردی Play Integrity تشخیص می‌دهد که دستگاه در حال اجرای یک سیستم‌عامل آسیب‌پذیر است (بررسی اولیه‌ی Integrity ناموفق بود).
HARDWARE_BACKED_EVALUATION_FAILED اگر برچسب MEETS_STRONG_INTEGRITY در فیلد یکپارچگی دستگاه نمایش داده نشود، Play Integrity API تشخیص می‌دهد که دستگاه ضمانت قوی برای یکپارچگی سیستم ندارد.

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

اطلاعات مربوط به حالت معیارهای مشترک - استانداردهای امنیتی تعریف شده در معیارهای مشترک برای ارزیابی امنیت فناوری اطلاعات (CC).

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

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

enum ( CommonCriteriaModeStatus )

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

policySignatureVerificationStatus

enum ( PolicySignatureVerificationStatus )

Output only. The status of policy signature verification.

CommonCriteriaModeStatus

Whether Common Criteria Mode is enabled.

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Unknown status.
COMMON_CRITERIA_MODE_DISABLED Common Criteria Mode is currently disabled.
COMMON_CRITERIA_MODE_ENABLED Common Criteria Mode is currently enabled.

PolicySignatureVerificationStatus

The status of policy signature verification.

Enums
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Unspecified. The verification status has not been reported. This is set only if statusReportingSettings.commonCriteriaModeEnabled is false.
POLICY_SIGNATURE_VERIFICATION_DISABLED Policy signature verification is disabled on the device as commonCriteriaMode is set to false.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED Policy signature verification succeeded.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED Policy signature verification is not supported, eg because the device has been enrolled with a CloudDPC version that does not support the policy signature verification.
POLICY_SIGNATURE_VERIFICATION_FAILED The policy signature verification failed. The policy has not been applied.

DpcMigrationInfo

Information related to whether this device was migrated from being managed by another Device Policy Controller (DPC).

JSON representation 
{
  "previousDpc": string,
  "additionalData": string
}
فیلدها
previousDpc

string

Output only. If this device was migrated from another DPC, this is its package name. Not populated otherwise.

additionalData

string

Output only. If this device was migrated from another DPC, the additionalData field of the migration token is populated here.

DefaultApplicationInfo

The default application information for a specific DefaultApplicationType .

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

enum ( DefaultApplicationType )

Output only. The default application type.

packageName

string

Output only. The package name of the current default application.

defaultApplicationSettingAttempts[]

object ( DefaultApplicationSettingAttempt )

Output only. Details on the default application setting attempts, in the same order as listed in defaultApplications .

DefaultApplicationSettingAttempt

Details on a default application setting attempt.

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

string

Output only. The package name of the attempted application.

attemptOutcome

enum ( AttemptOutcome )

Output only. The outcome of setting the app as the default.

AttemptOutcome

The outcome of setting the app as the default.

Enums
ATTEMPT_OUTCOME_UNSPECIFIED Attempt outcome is unspecified. This is not used.
SUCCESS App is successfully set as the default.
APP_NOT_INSTALLED Attempt failed as the app is not installed.
APP_SIGNING_CERT_MISMATCH Attempt failed as the signing key certificate fingerprint of the app from Play Store or from ApplicationPolicy.signingKeyCerts does not match the one on the device.
OTHER_FAILURE Attempt failed due to other reasons.

Methods

delete

 Deletes a device.

get

 Gets a device.

issueCommand

 Issues a command to a device.

list

 Lists devices for a given enterprise.

patch

 Updates a device.