Важно! Мы больше не принимаем новых регистраций для Play EMM API. Узнать больше .

Эта страница переведена с помощью Cloud Translation API.

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 в сервисах 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` позволяет пользователю устройства настраивать политику обновления приложений. `always` включает автоматические обновления. `never` не отключает автоматические обновления. `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. policyId`	`string`	Идентификатор политики, который будет передан вместе с отзывом об установке приложения, отправленным из Play Store.
`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» .