Devices

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

بازنمایی منابع

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

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}
نام ملک ارزش توضیحات یادداشت ها
androidId string شناسه Android Services Google Play برای دستگاه به صورت یک رشته هگز با حروف کوچک کدگذاری شده است. به عنوان مثال، "123456789abcdef0" .
device string نام رمز سخت افزار داخلی دستگاه. این از android.os.Build.DEVICE می آید. (فیلدی با نام "دستگاه" در هر log/wireless/android/android_checkin.proto)
kind string
latestBuildFingerprint string اثر انگشت ساخت دستگاه اگر مشخص باشد.
maker string سازنده دستگاه. این از android.os.Build.MANUFACTURER می آید.
managementType string میزان کنترل دستگاه توسط یک EMM مدیریت شده Google Play در پیکربندی‌های مختلف استقرار را مشخص می‌کند.

مقادیر ممکن عبارتند از:
  • « managedDevice »، دستگاهی که کنترل‌کننده خط‌مشی دستگاه EMM (DPC) را به عنوان مالک دستگاه دارد.
  • « managedProfile »، دستگاهی که نمایه‌ای دارد که توسط DPC مدیریت می‌شود (DPC مالک نمایه است) علاوه بر نمایه شخصی جداگانه که برای DPC در دسترس نیست.
  • " containerApp " دیگر استفاده نمی شود (منسوخ شده است).
  • " unmanagedProfile "، دستگاهی که اجازه استفاده از Google Play مدیریت شده را داشته است (توسط سرپرست دامنه، با استفاده از کنسول مدیریت برای فعال کردن امتیاز) از Google Play مدیریت شده استفاده کند، اما خود نمایه متعلق به یک DPC نیست.


مقادیر قابل قبول عبارتند از:
  • " containerApp "
  • " managedDevice "
  • " managedProfile "
  • " unmanagedProfile "
model string نام مدل دستگاه این از android.os.Build.MODEL می آید.
policy nested object خط مشی اعمال شده در دستگاه.
policy. autoUpdatePolicy string زمان اعمال به‌روزرسانی خودکار برنامه در دستگاه را کنترل می‌کند.

جایگزین توصیه شده: autoUpdateMode که برای هر برنامه تنظیم می شود، انعطاف پذیری بیشتری را در مورد فرکانس به روز رسانی ارائه می دهد.

وقتی autoUpdateMode روی AUTO_UPDATE_POSTPONED یا AUTO_UPDATE_HIGH_PRIORITY تنظیم شده است، autoUpdatePolicy تأثیری ندارد.

"choiceToTheUser" به کاربر دستگاه اجازه می دهد تا خط مشی به روز رسانی برنامه را پیکربندی کند. "همیشه" به روز رسانی خودکار را فعال می کند. "هرگز" به روز رسانی خودکار را غیرفعال می کند. "wifiOnly" به روز رسانی خودکار را تنها زمانی فعال می کند که دستگاه به وای فای متصل باشد.

مقادیر قابل قبول عبارتند از:
  • " always "
  • " choiceToTheUser "
  • " never "
  • " wifiOnly "
policy. deviceReportPolicy string اینکه آیا دستگاه وضعیت های برنامه را به EMM گزارش می دهد یا خیر. مقدار پیش فرض "deviceReportDisabled" است.

مقادیر قابل قبول عبارتند از:
  • " deviceReportDisabled "
  • " deviceReportEnabled "
policy. maintenanceWindow nested object پنجره تعمیر و نگهداری که مشخص می کند برنامه های در حال اجرا در پیش زمینه باید به روز شوند.
policy.maintenanceWindow. durationMs long مدت زمان پنجره نگهداری، بر حسب میلی ثانیه. مدت زمان باید بین 30 دقیقه تا 24 ساعت (شامل) باشد.
policy.maintenanceWindow. startTimeAfterMidnightMs long زمان شروع پنجره تعمیر و نگهداری، در میلی ثانیه پس از نیمه شب در دستگاه. ویندوز می تواند نیمه شب باشد.
policy. productAvailabilityPolicy string در دسترس بودن اعطا شده به دستگاه برای محصولات مشخص شده. "all" به دستگاه امکان دسترسی به همه محصولات را بدون توجه به وضعیت تایید می دهد. "همه" قابلیت مشاهده خودکار تراک های "آلفا" یا "بتا" را فعال نمی کند. "لیست سفید" به دستگاه اجازه دسترسی به محصولات مشخص شده در productPolicy[] را می دهد. فقط محصولاتی که تایید شده اند یا محصولاتی که قبلا تایید شده اند (محصولات با تاییدیه لغو شده) توسط شرکت می توانند در لیست سفید قرار بگیرند. اگر مقداری ارائه نشود، در دسترس بودن تنظیم شده در سطح کاربر به طور پیش فرض اعمال می شود.

مقادیر قابل قبول عبارتند از:
  • " all "
  • " whitelist "
policy. productPolicy[] list لیست سیاست های محصول برای اعمال خط‌مشی‌های productAvailabilityPolicy باید روی WHITELIST یا ALL تنظیم شود.
policy.productPolicy[]. autoInstallPolicy nested object خط مشی نصب خودکار برای محصول.
policy.productPolicy[].autoInstallPolicy. autoInstallConstraint[] list محدودیت‌های نصب خودکار برنامه شما می توانید حداکثر یک محدودیت را تعیین کنید.

policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]. chargingStateConstraint string محدودیت حالت شارژ

مقادیر قابل قبول عبارتند از:
  • " chargingNotRequired "
  • " chargingRequired "
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]. deviceIdleStateConstraint string محدودیت حالت بیکار دستگاه.

مقادیر قابل قبول عبارتند از:
  • " deviceIdleNotRequired "
  • " deviceIdleRequired "
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]. networkTypeConstraint string محدودیت نوع شبکه

مقادیر قابل قبول عبارتند از:
  • " anyNetwork "
  • " unmeteredNetwork "
policy.productPolicy[].autoInstallPolicy. autoInstallMode string حالت نصب خودکار اگر تنظیم نشده باشد، پیش‌فرض «doNotAutoInstall» است. یک برنامه به طور خودکار بدون در نظر گرفتن یک پنجره نگهداری تنظیم شده نصب می شود.

مقادیر قابل قبول عبارتند از:
  • " autoInstallOnce "
  • " doNotAutoInstall "
  • " forceAutoInstall "
policy.productPolicy[].autoInstallPolicy. autoInstallPriority integer اولویت نصب، به عنوان یک عدد صحیح بدون علامت. عدد کمتر به معنای اولویت بیشتر است.
policy.productPolicy[].autoInstallPolicy. minimumVersionCode integer حداقل نسخه برنامه اگر نسخه پایین‌تری از برنامه نصب شده باشد، به‌جای اینکه منتظر به‌روزرسانی خودکار معمولی باشد، برنامه مطابق با محدودیت‌های نصب خودکار به‌روزرسانی می‌شود. می توانید حداقل کد نسخه را برای حداکثر 20 برنامه در هر دستگاه تنظیم کنید.
policy.productPolicy[]. autoUpdateMode string حالت به روز رسانی خودکار برای محصول. هنگامی که autoUpdateMode استفاده می شود، همیشه بر انتخاب کاربر اولویت دارد. بنابراین زمانی که کاربر تغییراتی را در تنظیمات دستگاه به صورت دستی انجام می دهد، این تغییرات نادیده گرفته می شوند.

مقادیر قابل قبول عبارتند از:
  • autoUpdateDefault
  • " autoUpdateHighPriority "
  • " autoUpdatePostponed "
policy.productPolicy[]. enterpriseAuthenticationAppLinkConfigs[] list یک پیکربندی URL احراز هویت برای برنامه احراز هویت یک ارائه دهنده هویت. این به راه‌اندازی برنامه احراز هویت ارائه‌دهنده هویت در حین احراز هویت که در یک برنامه خصوصی با استفاده از Android WebView انجام می‌شود، کمک می‌کند. برنامه Authenticator از قبل باید کنترل کننده پیش فرض نشانی اینترنتی احراز هویت در دستگاه باشد.
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]. uri string یک آدرس اینترنتی احراز هویت
policy.productPolicy[]. managedConfiguration nested object پیکربندی مدیریت شده برای محصول
policy.productPolicy[].managedConfiguration. configurationVariables nested object شامل شناسه نمایه پیکربندی مدیریت شده و مجموعه ای از متغیرهای پیکربندی (در صورت وجود) تعریف شده برای کاربر است.
policy.productPolicy[].managedConfiguration.configurationVariables. kind string
policy.productPolicy[].managedConfiguration.configurationVariables. mcmId string شناسه تنظیمات پیکربندی مدیریت شده.
policy.productPolicy[].managedConfiguration.configurationVariables. variableSet[] list مجموعه متغیری که به کاربر نسبت داده می شود.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]. kind string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]. placeholder string رشته نگهدارنده مکان؛ توسط EMM تعریف شده است.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]. userValue string مقدار مکان نگهدار، مخصوص کاربر.
policy.productPolicy[].managedConfiguration. kind string منسوخ شده است.

policy.productPolicy[].managedConfiguration. managedProperty[] list مجموعه ای از ویژگی های مدیریت شده برای این پیکربندی.
policy.productPolicy[].managedConfiguration.managedProperty[]. key string کلید منحصر به فرد که دارایی را شناسایی می کند.
policy.productPolicy[].managedConfiguration.managedProperty[]. valueBool boolean مقدار بولی - این فقط در صورتی وجود دارد که نوع خاصیت bool باشد.
policy.productPolicy[].managedConfiguration.managedProperty[]. valueBundle nested object بسته‌ای از ویژگی‌های مدیریت‌شده - این تنها در صورتی وجود خواهد داشت که نوع ویژگی بسته‌ای باشد.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle. managedProperty[] list لیست املاک مدیریت شده
policy.productPolicy[].managedConfiguration.managedProperty[]. valueBundleArray[] list لیست بسته‌های خصوصیات - این فقط در صورتی وجود دارد که نوع خاصیت bundle_array باشد.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]. managedProperty[] list لیست املاک مدیریت شده
policy.productPolicy[].managedConfiguration.managedProperty[]. valueInteger integer مقدار صحیح - این فقط در صورتی وجود دارد که نوع خاصیت عدد صحیح باشد.
policy.productPolicy[].managedConfiguration.managedProperty[]. valueString string مقدار رشته - این فقط در صورتی وجود دارد که نوع خاصیت رشته ای، انتخابی یا مخفی باشد.
policy.productPolicy[].managedConfiguration.managedProperty[]. valueStringArray[] list لیست مقادیر رشته - این فقط در صورتی وجود دارد که نوع خاصیت چند انتخابی باشد.
policy.productPolicy[].managedConfiguration. productId string شناسه محصولی که پیکربندی مدیریت شده برای آن است، به عنوان مثال "app:com.google.android.gm".
policy.productPolicy[]. productId string شناسه محصول. به عنوان مثال، "app:com.google.android.gm" .
policy.productPolicy[]. trackIds[] list قابلیت مشاهده دستگاه را به آهنگ(های) انتشار محصول مشخص شده، که توسط trackIds شناسایی شده اند، می دهد. لیست آهنگ های انتشار یک محصول را می توان با تماس با Products.Get دریافت کرد.
policy.productPolicy[]. tracks[] list منسوخ شده است. به جای آن از trackIds استفاده کنید.
product string نام محصول دستگاه این از android.os.Build.PRODUCT می آید.
report nested object گزارش دستگاه با آخرین وضعیت برنامه به روز شد.
report. appState[] list فهرست وضعیت‌های برنامه که توسط برنامه‌های مدیریت‌شده روی دستگاه تنظیم شده است. حالت های برنامه توسط توسعه دهندگان برنامه تعریف می شود. این میدان همیشه وجود خواهد داشت.
report.appState[]. keyedAppState[] list فهرست حالت های برنامه کلیددار. این میدان همیشه وجود خواهد داشت.
report.appState[].keyedAppState[]. data string فیلد اضافی در نظر گرفته شده برای داده های قابل خواندن توسط ماشین. به عنوان مثال، یک عدد یا شی JSON. برای جلوگیری از XSS، توصیه می‌کنیم هر HTML را قبل از نمایش داده‌ها حذف کنید.
report.appState[].keyedAppState[]. key string کلید نشان می دهد که برنامه برای چه وضعیتی ارائه می دهد. محتوای کلید توسط توسعه دهنده برنامه تنظیم می شود. برای جلوگیری از XSS، توصیه می کنیم هر HTML را قبل از نمایش کلید از آن حذف کنید. این میدان همیشه وجود خواهد داشت.
report.appState[].keyedAppState[]. message string پیامی به شکل آزاد و قابل خواندن برای انسان که وضعیت برنامه را توصیف می کند. به عنوان مثال، یک پیام خطا. برای جلوگیری از XSS، توصیه می کنیم هر HTML را قبل از نمایش پیام از آن حذف کنید.
report.appState[].keyedAppState[]. severity string شدت وضعیت برنامه این میدان همیشه وجود خواهد داشت.

مقادیر قابل قبول عبارتند از:
  • " severityError "
  • " severityInfo "
report.appState[].keyedAppState[]. stateTimestampMillis long مُهر زمانی از زمانی که برنامه وضعیت را بر حسب میلی‌ثانیه از دوره تنظیم می‌کند. این میدان همیشه وجود خواهد داشت.
report.appState[]. packageName string نام بسته برنامه این میدان همیشه وجود خواهد داشت.
report. lastUpdatedTimestampMillis long مُهر زمانی آخرین به‌روزرسانی گزارش در میلی‌ثانیه از آن دوره. این میدان همیشه وجود خواهد داشت.
retailBrand string مارک خرده فروشی دستگاه، در صورت تنظیم. android.os.Build.BRAND را ببینید
sdkVersion integer نسخه سازگاری API.

روش ها

forceReportUpload
گزارشی را آپلود می‌کند که حاوی هرگونه تغییر در وضعیت برنامه از زمان ایجاد آخرین گزارش در دستگاه است. شما می توانید تا 3 بار در هر 24 ساعت برای یک دستگاه خاص با این روش تماس بگیرید.
دریافت کنید
جزئیات یک دستگاه را بازیابی می کند.
getState
فعال یا غیرفعال بودن دسترسی دستگاه به سرویس‌های Google را بازیابی می‌کند. وضعیت دستگاه تنها در صورتی اعمال می‌شود که اجرای خط‌مشی‌های EMM در دستگاه‌های Android در کنسول مدیریت Google فعال باشد. در غیر این صورت، وضعیت دستگاه نادیده گرفته می شود و همه دستگاه ها اجازه دسترسی به خدمات Google را دارند. این فقط برای کاربران تحت مدیریت گوگل پشتیبانی می شود.
فهرست
شناسه تمام دستگاه های کاربر را بازیابی می کند.
setState
تنظیم می کند که آیا دسترسی دستگاه به خدمات Google فعال یا غیرفعال باشد. وضعیت دستگاه تنها در صورتی اعمال می‌شود که اجرای خط‌مشی‌های EMM در دستگاه‌های Android در کنسول مدیریت Google فعال باشد. در غیر این صورت، وضعیت دستگاه نادیده گرفته می شود و همه دستگاه ها اجازه دسترسی به خدمات Google را دارند. این فقط برای کاربران تحت مدیریت گوگل پشتیبانی می شود.
به روز رسانی کنید
خط مشی دستگاه را به روز می کند.

برای اطمینان از اجرای صحیح این خط‌مشی، باید با تنظیم allowed_accounts در پیکربندی مدیریت‌شده برای بسته Google Play، از دسترسی حساب‌های مدیریت‌نشده به Google Play جلوگیری کنید. محدود کردن حساب‌ها را در Google Play ببینید.