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