Enterprises: pullNotificationSet

Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, прошедшей проверку подлинности для запроса. Набор уведомлений может быть пустым, если нет ожидающих уведомлений.
Возвращенный набор уведомлений необходимо подтвердить в течение 20 секунд, вызвав Enterprises.AcknowledgeNotificationSet, если только набор уведомлений не пуст.
Уведомления, которые не будут подтверждены в течение 20 секунд, в конечном итоге будут снова включены в ответ на другой запрос PullNotificationSet, а те, которые никогда не будут подтверждены, в конечном итоге будут удалены в соответствии с политикой системы Pub/Sub Google Cloud Platform.
Несколько запросов могут выполняться одновременно для получения уведомлений, и в этом случае ожидающие уведомления (если есть) будут разделены между каждым вызывающим абонентом, если таковые имеются.
Если уведомлений нет, возвращается пустой список уведомлений. Последующие запросы могут возвращать больше уведомлений, когда они становятся доступными.

Запрос

HTTP-запрос

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

Параметры

Имя параметра Ценить Описание
Необязательные параметры запроса
requestMode string Режим запроса для получения уведомлений.
Указание waitForNotifications приведет к блокировке запроса и ожиданию появления одного или нескольких уведомлений или возврату пустого списка уведомлений, если через некоторое время уведомлений не будет.
Указание returnImmediately приведет к тому, что запрос немедленно вернет ожидающие уведомления или пустой список, если уведомлений нет.
Если опущено, по умолчанию waitForNotifications .

Допустимые значения:
  • " returnImmediately "
  • " waitForNotifications "

Авторизация

Этот запрос требует авторизации со следующей областью действия:

Сфера
https://www.googleapis.com/auth/androidenterprise

Дополнительные сведения см. на странице аутентификации и авторизации .

Тело запроса

Не указывайте тело запроса с этим методом.

Ответ

В случае успеха этот метод возвращает тело ответа со следующей структурой:

{
  "kind": "androidenterprise#notificationSet",
  "notificationSetId": string,
  "notification": [
    {
      "enterpriseId": string,
      "timestampMillis": long,
      "notificationType": string,
      "productApprovalEvent": {
        "productId": string,
        "approved": string
      },
      "installFailureEvent": {
        "productId": string,
        "deviceId": string,
        "userId": string,
        "failureReason": string,
        "failureDetails": string
      },
      "appUpdateEvent": {
        "productId": string
      },
      "newPermissionsEvent": {
        "productId": string,
        "requestedPermissions": [
          string
        ],
        "approvedPermissions": [
          string
        ]
      },
      "appRestrictionsSchemaChangeEvent": {
        "productId": string
      },
      "productAvailabilityChangeEvent": {
        "productId": string,
        "availabilityStatus": string
      },
      "newDeviceEvent": {
        "userId": string,
        "deviceId": string,
        "managementType": string,
        "dpcPackageName": string
      },
      "deviceReportUpdateEvent": {
        "userId": string,
        "deviceId": string,
        "report": {
          "lastUpdatedTimestampMillis": long,
          "appState": [
            {
              "packageName": string,
              "keyedAppState": [
                {
                  "key": string,
                  "stateTimestampMillis": long,
                  "severity": string,
                  "message": string,
                  "data": string
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Имя свойства Ценить Описание Ноты
notificationSetId string Идентификатор набора уведомлений, необходимый для пометки уведомления как полученного с помощью API Enterprises.AcknowledgeNotification. Это будет опущено, если нет уведомлений.
notification[] list Полученные уведомления или пустые, если уведомлений нет.
notification[]. enterpriseId string Идентификатор предприятия, для которого отправляется уведомление. Это всегда будет присутствовать.
notification[]. timestampMillis long Время публикации уведомления в миллисекундах с 1970-01-01T00:00:00Z. Это всегда будет присутствовать.
notification[]. productApprovalEvent nested object Уведомления об изменении статуса одобрения продукта.
notification[].productApprovalEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), для которого изменился статус утверждения. Это поле всегда будет присутствовать.
notification[].productApprovalEvent. approved string Был ли продукт одобрен или нет. Это поле всегда будет присутствовать.

Допустимые значения:
  • " approved "
  • " unapproved "
  • " unknown "
notification[]. installFailureEvent nested object Уведомления о сбое установки приложения.
notification[].installFailureEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), для которого произошла ошибка установки. Это поле всегда будет присутствовать.
notification[].installFailureEvent. deviceId string Идентификатор Android устройства. Это поле всегда будет присутствовать.
notification[].installFailureEvent. userId string Идентификатор пользователя. Это поле всегда будет присутствовать.
notification[].installFailureEvent. failureReason string Причина сбоя установки. Это поле всегда будет присутствовать.

Допустимые значения:
  • " timeout "
  • " unknown "
notification[].installFailureEvent. failureDetails string Дополнительные сведения о сбое, если применимо.
notification[]. appUpdateEvent nested object Уведомления об обновлениях приложения.
notification[].appUpdateEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), который был обновлен. Это поле всегда будет присутствовать.
notification[]. newPermissionsEvent nested object Уведомления о новых разрешениях приложений.
notification[].newPermissionsEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), для которого были добавлены новые разрешения. Это поле всегда будет присутствовать.
notification[].newPermissionsEvent. requestedPermissions[] list Набор разрешений, которые в данный момент запрашивает приложение. Используйте Permissions.Get в EMM API, чтобы получить сведения об этих разрешениях.
notification[].newPermissionsEvent. approvedPermissions[] list Набор разрешений, который администратор предприятия уже утвердил для этого приложения. Используйте Permissions.Get в EMM API, чтобы получить сведения об этих разрешениях.
notification[]. appRestrictionsSchemaChangeEvent nested object Уведомления о новых изменениях схемы ограничений приложений.
notification[].appRestrictionsSchemaChangeEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), для которого изменилась схема ограничения приложений. Это поле всегда будет присутствовать.
notification[]. productAvailabilityChangeEvent nested object Уведомления об изменении наличия товара.
notification[].productAvailabilityChangeEvent. productId string Идентификатор продукта (например, "app:com.google.android.gm"), доступность которого изменилась. Это поле всегда будет присутствовать.
notification[].productAvailabilityChangeEvent. availabilityStatus string Новое состояние продукта. Это поле всегда будет присутствовать.

Допустимые значения:
  • " available "
  • " removed "
  • " unknown "
  • " unpublished "
notification[]. newDeviceEvent nested object Уведомления о новых устройствах.
notification[].newDeviceEvent. userId string Идентификатор пользователя. Это поле всегда будет присутствовать.
notification[].newDeviceEvent. deviceId string Идентификатор Android устройства. Это поле всегда будет присутствовать.
notification[].newDeviceEvent. managementType string Определяет степень, в которой устройство управляется Android EMM в различных конфигурациях развертывания.

Возможные значения включают в себя:
  • " managedDevice ", устройство, где DPC является владельцем устройства,
  • « managedProfile », устройство, на котором DPC указан как владелец профиля.


Допустимые значения:
  • " managedDevice "
  • " managedProfile "
notification[]. notificationType string Тип уведомления.

Допустимые значения:
  • " appRestricionsSchemaChange "
  • " appUpdate "
  • " deviceReportUpdate "
  • " installFailure "
  • " newDevice "
  • " newPermissions "
  • " productApproval "
  • " productAvailabilityChange "
  • " testNotification "
  • " unknown "
notification[].newDeviceEvent. dpcPackageName string Приложение политики на устройстве.
notification[]. deviceReportUpdateEvent nested object Уведомления об обновлениях отчетов устройства.
notification[].deviceReportUpdateEvent. userId string Идентификатор пользователя. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent. deviceId string Идентификатор Android устройства. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent. report nested object Отчет об устройстве обновлен с учетом последних состояний приложения. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report. lastUpdatedTimestampMillis long Отметка времени последнего обновления отчета в миллисекундах с начала эпохи. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report. appState[] list Список состояний приложений, заданных управляемыми приложениями на устройстве. Состояния приложения определяются разработчиками приложения. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report.appState[]. packageName string Имя пакета приложения. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report.appState[]. keyedAppState[] list Список ключевых состояний приложения. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. key string Ключ, указывающий, для чего приложение предоставляет состояние. Содержимое ключа задается разработчиком приложения. Чтобы предотвратить XSS, мы рекомендуем удалить весь HTML-код из ключа перед его отображением. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. stateTimestampMillis long Отметка времени, когда приложение установило состояние в миллисекундах с начала эпохи. Это поле всегда будет присутствовать.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. severity string Серьезность состояния приложения. Это поле всегда будет присутствовать.

Допустимые значения:
  • " severityError "
  • " severityInfo "
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. message string Удобочитаемое сообщение в произвольной форме, описывающее состояние приложения. Например, сообщение об ошибке. Чтобы предотвратить XSS, мы рекомендуем удалить весь HTML-код из сообщения перед его отображением.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. data string Дополнительное поле, предназначенное для машиночитаемых данных. Например, число или объект JSON. Чтобы предотвратить XSS, мы рекомендуем удалять любой HTML из данных перед их отображением.
kind string