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 в сервисах Google Play для устройства, закодированный в виде шестнадцатеричной строки в нижнем регистре. Например, "123456789abcdef0" .
device	string	Внутреннее аппаратное кодовое имя устройства. Это происходит из android.os.Build.DEVICE . (поле с именем «устройство» в журналах/wireless/android/android_checkin.proto)
kind	string
latestBuildFingerprint	string	Отпечаток сборки устройства, если он известен.
maker	string	Производитель устройства. Это происходит из android.os.Build.MANUFACTURER .
managementType	string	Определяет степень, в которой устройство контролируется управляемым EMM Google Play в различных конфигурациях развертывания. Возможные значения включают в себя: « managedDevice » — устройство, владельцем которого является контроллер политики устройства (DPC) EMM. « managedProfile » — устройство, имеющее профиль, управляемый ЦОД (DPC — владелец профиля), в дополнение к отдельному личному профилю, который недоступен для ЦОД. « containerApp », больше не используется (устарело). « unmanagedProfile » — устройство, которому разрешено (администратором домена с помощью консоли администратора для включения этой привилегии) ​​использовать управляемый Google Play, но сам профиль не принадлежит ЦОД. Приемлемые значения: " 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» включает автоматическое обновление только тогда, когда устройство подключено к Wi-Fi. Приемлемые значения: " 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	Доступность, предоставленная устройству для указанных продуктов. «все» предоставляет устройству доступ ко всем продуктам, независимо от статуса одобрения. «все» не включает автоматическую видимость «альфа» или «бета»-треков. «Белый список» предоставляет устройству доступ к продуктам, указанным в 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 уже должно быть обработчиком по умолчанию для URL-адреса аутентификации на устройстве.
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]. uri	string	URL-адрес аутентификации.
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. Состояние устройства вступает в силу, только если в консоли администратора Google включено применение политик EMM на устройствах Android. В противном случае состояние устройства игнорируется, и всем устройствам разрешен доступ к сервисам Google. Это поддерживается только для пользователей, управляемых Google.

список

Получает идентификаторы всех устройств пользователя.

setState

Определяет, включен или отключен доступ устройства к службам Google. Состояние устройства вступает в силу, только если в консоли администратора Google включено применение политик EMM на устройствах Android. В противном случае состояние устройства игнорируется, и всем устройствам разрешен доступ к сервисам Google. Это поддерживается только для пользователей, управляемых Google.

обновлять

Обновляет политику устройства.

Чтобы обеспечить правильное соблюдение политики, вам необходимо запретить неуправляемым учетным записям доступ к Google Play, установив allowed_accounts в управляемой конфигурации пакета Google Play. См. раздел «Ограничение учетных записей в Google Play ».