Enterprises: pullNotificationSet

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

Запрос

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 в API EMM, чтобы получить подробную информацию об этих разрешениях.
notification[].newPermissionsEvent. approvedPermissions[] list Набор разрешений, которые администратор предприятия уже утвердил для этого приложения. Используйте Permissions.Get в API EMM, чтобы получить подробную информацию об этих разрешениях.
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 Приложение Policy на устройстве.
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