مهم: ما دیگر ثبت نام های جدید برای Play EMM API را نمی پذیریم. بیشتر بدانید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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,
    "policyId": 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` به کاربر دستگاه اجازه می دهد تا خط مشی به روز رسانی برنامه را پیکربندی کند. `always` به روز رسانی خودکار را فعال می کند. `never` به روز رسانی خودکار را غیرفعال نمی کند. `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. policyId`	`string`	شناسه‌ای برای خط‌مشی که با بازخورد نصب برنامه از فروشگاه Play ارسال می‌شود.
`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 ببینید.