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 ».