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 ببینید.

،

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

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

یک منبع 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 ببینید.

،

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

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

یک منبع 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 ببینید.