REST Resource: enterprises.devices

منبع: دستگاه

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

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

string

نام دستگاه به شکل enterprises/{enterpriseId}/devices/{deviceId} .

userName

string

نام منبع کاربری که این دستگاه را در اختیار دارد به شکل enterprises/{enterpriseId}/users/{userId} .

managementMode

enum ( ManagementMode )

نوع حالت مدیریت Android 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)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

lastStatusReportTime

string ( Timestamp format)

آخرین باری که دستگاه گزارش وضعیت ارسال کرد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

lastPolicyComplianceReportTime
(deprecated)

string ( Timestamp format)

منسوخ.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

lastPolicySyncTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

policyName

string

نام خط‌مشی اعمال‌شده روی دستگاه، به شکل enterprises/{enterpriseId}/policies/{policyId} . اگر مشخص نشده باشد، policyName برای کاربر دستگاه اعمال می شود. این فیلد را می توان با یک درخواست پچ تغییر داد. شما می توانید فقط policyId هنگام فراخوانی enterprises.devices.patch مشخص کنید، تا زمانی که policyId حاوی هیچ گونه اسلش نباشد. بقیه نام خط مشی استنباط می شود.

appliedPolicyName

string

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

appliedPolicyVersion

string ( int64 format)

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

apiLevel

integer

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

enrollmentTokenData

string

اگر دستگاه با یک رمز ثبت نام با داده های اضافی ارائه شده ثبت شده است، این قسمت حاوی آن داده است.

enrollmentTokenName

string

اگر دستگاه با رمز ثبت نام ثبت شده است، این فیلد حاوی نام رمز است.

disabledReason

object ( UserFacingMessage )

اگر وضعیت دستگاه DISABLED باشد، یک پیام اختیاری که دلیل غیرفعال شدن دستگاه را نشان می دهد، روی دستگاه نمایش داده می شود. این فیلد را می توان با یک درخواست پچ تغییر داد.

softwareInfo

object ( SoftwareInfo )

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

hardwareInfo

object ( HardwareInfo )

اطلاعات دقیق در مورد سخت افزار دستگاه

displays[]

object ( Display )

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

applicationReports[]

object ( ApplicationReport )

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

previousDeviceNames[]

string

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

networkInfo

object ( NetworkInfo )

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

memoryInfo

object ( MemoryInfo )

اطلاعات حافظه: حاوی اطلاعاتی در مورد حافظه و حافظه دستگاه است.

memoryEvents[]

object ( MemoryEvent )

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

رویدادها برای مدت معینی حفظ می شوند و رویدادهای قدیمی حذف می شوند.

powerManagementEvents[]

object ( PowerManagementEvent )

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

hardwareStatusSamples[]

object ( HardwareStatus )

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

deviceSettings

object ( DeviceSettings )

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

user

object ( User )

کاربری که صاحب دستگاه است.

systemProperties

map (key: string, value: string)

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

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

securityPosture

object ( SecurityPosture )

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

ownership

enum ( Ownership )

مالکیت دستگاه مدیریت شده

commonCriteriaModeInfo

object ( CommonCriteriaModeInfo )

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

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

appliedPasswordPolicies[]

object ( PasswordRequirements )

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

  • الزامات اعمال شده ممکن است در برخی موارد کمی متفاوت از مواردی باشد که در passwordPolicies مشخص شده است.
  • fieldPath بر اساس passwordPolicies تنظیم شده است.
dpcMigrationInfo

object ( DpcMigrationInfo )

فقط خروجی اطلاعات مربوط به اینکه آیا این دستگاه از مدیریت یک کنترلر سیاست دستگاه دیگر (DPC) منتقل شده است یا خیر.

DeviceState

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

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

NonComplianceDetail

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

نمایندگی JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
زمینه های
settingName

string

نام تنظیم خط مشی. این نام فیلد JSON یک فیلد سطح بالای Policy است.

nonComplianceReason

enum ( NonComplianceReason )

دلیل عدم انطباق دستگاه با تنظیمات

packageName

string

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

fieldPath

string

برای تنظیمات دارای فیلدهای تودرتو، اگر یک فیلد تودرتو خاص مطابقت نداشته باشد، این مسیر کامل به فیلد متخلف را مشخص می کند. مسیر به همان شکلی قالب بندی می شود که فیلد JSON خط مشی در جاوا اسکریپت ارجاع داده می شود، یعنی: 1) برای فیلدهای شی تایپ شده، نام فیلد با یک نقطه و سپس با نام زیر فیلد دنبال می شود. 2) برای فیلدهای آرایه‌ای، پس از نام فیلد، فهرست آرایه در پرانتز قرار می‌گیرد. به عنوان مثال، برای نشان دادن مشکل با فیلد url در فیلد externalData در برنامه سوم، مسیر applications[2].externalData.url خواهد بود.

currentValue

value ( Value format)

اگر تنظیم خط‌مشی را نمی‌توان اعمال کرد، مقدار فعلی تنظیم در دستگاه.

installationFailureReason

enum ( InstallationFailureReason )

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

specificNonComplianceReason

enum ( SpecificNonComplianceReason )

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

specificNonComplianceContext

object ( SpecificNonComplianceContext )

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

Installation FailureReason

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

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

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

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

SpecificNonComplianceReason

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

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED دلیل خاصی برای عدم انطباق مشخص نشده است. فیلدها در specificNonComplianceContext تنظیم نشده اند.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED کاربر باید اعتبار خود را با وارد کردن قفل صفحه تأیید کند. فیلدها در specificNonComplianceContext تنظیم نشده اند. nonComplianceReason روی USER_ACTION تنظیم شده است.
PASSWORD_POLICIES_PASSWORD_EXPIRED گذرواژه دستگاه یا نمایه منقضی شده است. passwordPoliciesContext تنظیم شده است. nonComplianceReason روی USER_ACTION تنظیم شده است.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT رمز عبور دستگاه الزامات رمز عبور را برآورده نمی کند. passwordPoliciesContext تنظیم شده است. nonComplianceReason روی USER_ACTION تنظیم شده است.
ONC_WIFI_INVALID_VALUE مقدار نادرستی در پیکربندی Wi-Fi ONC وجود دارد. fieldPath مشخص می کند که کدام مقدار فیلد نادرست است. oncWifiContext تنظیم شده است. nonComplianceReason روی INVALID_VALUE تنظیم شده است.
ONC_WIFI_API_LEVEL تنظیم ONC Wi-Fi در سطح API نسخه Android در حال اجرا بر روی دستگاه پشتیبانی نمی شود. fieldPath مشخص می کند که کدام مقدار فیلد پشتیبانی نمی شود. oncWifiContext تنظیم شده است. nonComplianceReason روی API_LEVEL تنظیم شده است.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG شبکه Wi-Fi سازمانی فاقد CA ریشه یا نام دامنه است. nonComplianceReason روی INVALID_VALUE تنظیم شده است.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK کاربر باید شبکه Wi-Fi پیکربندی شده را به صورت دستی حذف کند. این فقط در نمایه‌های کاری در دستگاه‌های شخصی قابل اعمال است. nonComplianceReason روی USER_ACTION تنظیم شده است.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY نام مستعار جفت کلید مشخص شده از طریق فیلد ClientCertKeyPairAlias ​​در openNetworkConfiguration با کلید موجود نصب شده در دستگاه مطابقت ندارد. nonComplianceReason روی INVALID_VALUE تنظیم شده است.

SpecificNonComplianceContext

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

نمایندگی JSON
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
زمینه های
oncWifiContext

object ( OncWifiContext )

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

passwordPoliciesContext

object ( PasswordPoliciesContext )

زمینه اضافی برای عدم انطباق مربوط به سیاست های رمز عبور. به PASSWORD_POLICIES_PASSWORD_EXPIRED و PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT مراجعه کنید.

OncWifiContext

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

نمایندگی JSON
{
  "wifiGuid": string
}
زمینه های
wifiGuid

string

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

PasswordPoliciesContext

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

نمایندگی JSON
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
زمینه های
passwordPolicyScope

enum ( PasswordPolicyScope )

دامنه رمز عبور ناسازگار.

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

اطلاعاتی در مورد نرم افزار دستگاه

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

کد نسخه برنامه Android Device Policy.

androidDevicePolicyVersionName

string

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

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)

ساخت زمان.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

securityPatchLevel

string

سطح وصله امنیتی، به عنوان مثال 2016-05-01 .

primaryLanguageCode

string

یک کد زبان IETF BCP 47 برای زبان اصلی روی دستگاه.

deviceBuildSignature

string

SHA-256 هش android.content.pm.Signature مرتبط با بسته سیستم، که می تواند برای تأیید عدم تغییر ساختار سیستم استفاده شود.

systemUpdateInfo

object ( SystemUpdateInfo )

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

System UpdateInfo

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

نمایندگی JSON
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
زمینه های
updateStatus

enum ( UpdateStatus )

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

updateReceivedTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

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

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

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

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

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

نمایندگی JSON
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
زمینه های
brand

string

برند دستگاه. به عنوان مثال، Google .

hardware

string

نام سخت افزار. به عنوان مثال، Angler .

deviceBasebandVersion

string

نسخه بیس باند. به عنوان مثال، MDM9625_104662.22.05.34p .

manufacturer

string

سازنده. به عنوان مثال، Motorola .

serialNumber

string

شماره سریال دستگاه

model

string

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

batteryShutdownTemperatures[]

number

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

batteryThrottlingTemperatures[]

number

آستانه دمای کاهش فشار باتری بر حسب سانتیگراد برای هر باتری دستگاه.

cpuShutdownTemperatures[]

number

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

cpuThrottlingTemperatures[]

number

آستانه دمای throttling CPU بر حسب سانتیگراد برای هر CPU در دستگاه.

gpuShutdownTemperatures[]

number

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

gpuThrottlingTemperatures[]

number

آستانه دمای کاهش فشار GPU بر حسب سانتیگراد برای هر GPU در دستگاه.

skinShutdownTemperatures[]

number

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

skinThrottlingTemperatures[]

number

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

enterpriseSpecificId

string

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

نمایش دادن

اطلاعات نمایش دستگاه

نمایندگی JSON
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
زمینه های
name

string

نام نمایشگر

displayId

integer

شناسه نمایش منحصر به فرد

refreshRate

integer

نرخ تازه سازی نمایشگر بر حسب فریم در ثانیه.

state

enum ( DisplayState )

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

width

integer

عرض نمایش بر حسب پیکسل

height

integer

نمایش ارتفاع بر حسب پیکسل

density

integer

چگالی نمایشگر به صورت نقطه در اینچ بیان می شود.

DisplayState

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

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

ApplicationReport

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

نمایندگی JSON
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
زمینه های
packageName

string

نام بسته برنامه

versionName

string

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

versionCode

integer

کد نسخه برنامه، که می تواند برای تعیین جدیدتر بودن یک نسخه از نسخه دیگر استفاده شود.

events[]

object ( ApplicationEvent )

لیست رویدادهای برنامه که در 30 ساعت گذشته رخ داده است.

displayName

string

نام نمایشی برنامه

packageSha256Hash

string

هش SHA-256 فایل APK برنامه، که می‌توان از آن برای تأیید عدم تغییر برنامه استفاده کرد. هر بایت از مقدار هش به عنوان یک عدد هگزادسیمال دو رقمی نشان داده می شود.

signingKeyCertFingerprints[]

string

هش SHA-1 هر android.content.pm.Signature مرتبط با بسته برنامه. هر بایت از هر مقدار هش به عنوان یک عدد هگزادسیمال دو رقمی نشان داده می شود.

installerPackageName

string

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

applicationSource

enum ( ApplicationSource )

منبع بسته.

state

enum ( ApplicationState )

وضعیت برنامه

keyedAppStates[]

object ( KeyedAppState )

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

userFacingType

enum ( UserFacingType )

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

ApplicationEvent

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

نمایندگی JSON
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
زمینه های
eventType

enum ( ApplicationEventType )

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

createTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

ApplicationEventType

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

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

منبع برنامه

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

Enums
APPLICATION_SOURCE_UNSPECIFIED برنامه از منبع نامشخصی بارگذاری شده است.
SYSTEM_APP_FACTORY_VERSION این یک برنامه سیستمی از تصویر کارخانه دستگاه است.
SYSTEM_APP_UPDATED_VERSION این یک برنامه سیستم به روز شده است.
INSTALLED_FROM_PLAY_STORE این برنامه از فروشگاه Google Play نصب شده است.

ApplicationState

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

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

KeyedAppState

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

نمایندگی JSON
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
زمینه های
key

string

کلید وضعیت برنامه به عنوان یک نقطه مرجع برای وضعیتی که برنامه برای آن ارائه می کند عمل می کند. به عنوان مثال، هنگام ارائه بازخورد پیکربندی مدیریت شده، این کلید می تواند کلید پیکربندی مدیریت شده باشد.

severity

enum ( Severity )

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

message

string

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

data

string

به صورت اختیاری، یک مقدار قابل خواندن توسط ماشین توسط EMM خوانده شود. به عنوان مثال، تنظیم مقادیری که سرپرست می‌تواند در کنسول EMM درخواست کند (مثلاً «به من اطلاع بده اگر داده‌های هشدار باتری < 10»).

createTime

string ( Timestamp format)

زمان ایجاد حالت برنامه در دستگاه.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

lastUpdateTime

string ( Timestamp format)

زمانی که وضعیت برنامه اخیراً به‌روزرسانی شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

شدت

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

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

UserFacingType

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

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

NetworkInfo

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

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

string

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

meid

string

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

wifiMacAddress

string

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

networkOperatorName
(deprecated)

string

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

telephonyInfos[]

object ( TelephonyInfo )

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

TelephonyInfo

اطلاعات تلفن مرتبط با سیم کارت داده شده در دستگاه. فقط در دستگاه‌های کاملاً مدیریت شده که از Android API سطح 23 شروع می‌شود، پشتیبانی می‌شود.

نمایندگی JSON
{
  "phoneNumber": string,
  "carrierName": string
}
زمینه های
phoneNumber

string

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

carrierName

string

نام شرکت مخابراتی مرتبط با این سیم کارت.

MemoryInfo

اطلاعاتی در مورد حافظه و حافظه دستگاه.

نمایندگی JSON
{
  "totalRam": string,
  "totalInternalStorage": string
}
زمینه های
totalRam

string ( int64 format)

کل RAM دستگاه بر حسب بایت.

totalInternalStorage

string ( int64 format)

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

MemoryEvent

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

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

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

enum ( MemoryEventType )

نوع رویداد

createTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

byteCount

string ( int64 format)

تعداد بایت‌های رایگان در رسانه، یا برای EXTERNAL_STORAGE_DETECTED ، ظرفیت کل بر حسب بایت رسانه ذخیره‌سازی.

MemoryEventType

نوع رویداد.

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

PowerManagementEvent

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

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

enum ( PowerManagementEventType )

نوع رویداد

createTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

batteryLevel

number

برای رویدادهای BATTERY_LEVEL_COLLECTED ، سطح باتری به عنوان درصد.

PowerManagementEventType

نوع رویداد.

Enums
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)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

batteryTemperatures[]

number

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

cpuTemperatures[]

number

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

gpuTemperatures[]

number

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

skinTemperatures[]

number

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

fanSpeeds[]

number

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

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

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

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

Enums
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 )

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

وضعیت دستگاه

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

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

PostureDetail

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

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

enum ( SecurityRisk )

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

advice[]

object ( UserFacingMessage )

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

خطر امنیتی

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

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

CommonCriteriaModeInfo

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

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

نمایندگی JSON
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
زمینه های
commonCriteriaModeStatus

enum ( CommonCriteriaModeStatus )

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

CommonCriteriaModeStatus

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

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN وضعیت نامعلوم
COMMON_CRITERIA_MODE_DISABLED حالت معیار مشترک در حال حاضر غیرفعال است.
COMMON_CRITERIA_MODE_ENABLED حالت معیار مشترک در حال حاضر فعال است.

DpcMigrationInfo

اطلاعات مربوط به اینکه آیا این دستگاه از مدیریت یک کنترلر سیاست دستگاه دیگر (DPC) منتقل شده است یا خیر.

نمایندگی JSON
{
  "previousDpc": string,
  "additionalData": string
}
زمینه های
previousDpc

string

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

additionalData

string

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

مواد و روش ها

delete

 یک دستگاه را حذف می کند.

get

 دستگاه می گیرد.

issueCommand

 دستوری را برای دستگاه صادر می کند.

list

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

patch

 یک دستگاه را به روز می کند.