Devices

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

Ресурс Devices представляет собой мобильное устройство, управляемое EMM и принадлежащее определенному корпоративному пользователю.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  }
}

Имя свойства	Ценить	Описание	Примечания
androidId	string	Android-идентификатор Google Play Services для устройства, закодированный в виде строчной шестнадцатеричной строки. Например, "123456789abcdef0" .
kind	string
managementType	string	Определяет степень, в которой устройство контролируется управляемой системой EMM Google Play в различных конфигурациях развертывания. Возможные значения включают в себя: « managedDevice » — устройство, владельцем которого является контроллер политик устройств (DPC) EMM. « managedProfile », устройство с профилем, управляемым DPC (DPC является владельцем профиля) в дополнение к отдельному личному профилю, который недоступен для DPC. « containerApp », больше не используется (устарело). " unmanagedProfile ", устройство, которому разрешено (администратором домена, с помощью консоли администратора, чтобы включить привилегию) использовать управляемый Google Play, но сам профиль не принадлежит DPC. Допустимые значения: " containerApp " " managedDevice " " managedProfile " " unmanagedProfile "
policy	nested object	Политика, применяемая на устройстве.
policy. autoUpdatePolicy	string	Рекомендуемая альтернатива: autoUpdateMode , который устанавливается для каждого приложения, обеспечивает большую гибкость в отношении частоты обновления. Если для autoUpdateMode установлено значение AUTO_UPDATE_POSTPONED или AUTO_UPDATE_HIGH_PRIORITY , это поле не действует. «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	Режим автообновления продукта. Допустимые значения: " autoUpdateDefault " " autoUpdateHighPriority " " autoUpdatePostponed "
policy.productPolicy[]. enterpriseAuthenticationAppLinkConfigs[]	list	Конфигурация URL-адреса проверки подлинности для приложения проверки подлинности поставщика удостоверений. Это помогает запустить приложение аутентификации поставщика удостоверений во время аутентификации, происходящей в частном приложении с помощью Android WebView. Приложение Authenticator уже должно быть [обработчиком по умолчанию](https://developer.android.com/training/app-links/verify-site-associations) для 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	Строка-заполнитель; определяется ЭММ.
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 .
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	Отметка времени последнего обновления отчета в миллисекундах с начала эпохи. Это поле всегда будет присутствовать.

Методы

ForceReportUpload

Загружает отчет, содержащий любые изменения в состояниях приложения на устройстве с момента создания последнего отчета. Вы можете вызывать этот метод до 3 раз каждые 24 часа для данного устройства.

получать

Получает сведения об устройстве.

получить состояние

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

список

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

setState

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

обновлять

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

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