Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, прошедшей проверку подлинности для запроса. Набор уведомлений может быть пустым, если нет ожидающих уведомлений.
Возвращенный набор уведомлений необходимо подтвердить в течение 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 .Допустимые значения:
|
Авторизация
Этот запрос требует авторизации со следующей областью действия:
Сфера |
---|
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 | Был ли продукт одобрен или нет. Это поле всегда будет присутствовать. Допустимые значения:
| |
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 | Причина сбоя установки. Это поле всегда будет присутствовать. Допустимые значения:
| |
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 | Новое состояние продукта. Это поле всегда будет присутствовать. Допустимые значения:
| |
notification[]. newDeviceEvent | nested object | Уведомления о новых устройствах. | |
notification[].newDeviceEvent. userId | string | Идентификатор пользователя. Это поле всегда будет присутствовать. | |
notification[].newDeviceEvent. deviceId | string | Идентификатор Android устройства. Это поле всегда будет присутствовать. | |
notification[].newDeviceEvent. managementType | string | Определяет степень, в которой устройство управляется Android EMM в различных конфигурациях развертывания. Возможные значения включают в себя:
Допустимые значения:
| |
notification[]. notificationType | string | Тип уведомления. Допустимые значения:
| |
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 | Серьезность состояния приложения. Это поле всегда будет присутствовать. Допустимые значения:
| |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. message | string | Удобочитаемое сообщение в произвольной форме, описывающее состояние приложения. Например, сообщение об ошибке. Чтобы предотвратить XSS, мы рекомендуем удалить весь HTML-код из сообщения перед его отображением. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]. data | string | Дополнительное поле, предназначенное для машиночитаемых данных. Например, число или объект JSON. Чтобы предотвратить XSS, мы рекомендуем удалять любой HTML из данных перед их отображением. | |
kind | string |