Configurar las notificaciones de EMM

Google Play genera notificaciones, denominadas notificaciones de EMM, en respuesta a varios eventos que afectan a una empresa. Por ejemplo, cuando se aprueba una app, el sistema envía una notificación ProductApprovalEvent.

Las notificaciones de EMM se asocian con una cuenta de servicio empresarial (ESA) específica. Como EMM, puedes configurar tu consola para mostrar alertas o mensajes a los administradores de TI de la empresa en función de las notificaciones que recibes.

Las notificaciones de EMM se envían con Cloud Pub/Sub de Google. Para obtener información detallada sobre cómo configurar notificaciones de Pub/Sub, consulta la Descripción general de suscriptores y la Guía del suscriptor de extracción.

Para confirmar que configuraste correctamente tu sistema para recibir notificaciones de EMM de Google Play y recuperar el nombre del tema de Cloud Pub/Sub al que debes conectar tu suscripción, llama a Enterprises.sendTestPushNotification.

El envío de una notificación de prueba valida la integración de tu EMM con el servicio de Google Cloud Pub/Sub para la empresa. Si las notificaciones de EMM están configuradas correctamente, la API muestra lo siguiente:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

Notificaciones de extracción

Google Cloud Pub/Sub admite dos mecanismos de notificación diferentes: push y pull. Sin embargo, solo se recomiendan las notificaciones de extracción. El enfoque de extracción no requiere ninguna configuración de servidor externo y funciona con ESA creadas de forma programática y manual. Otra ventaja de las notificaciones de extracción es que los clientes requieren poca o ninguna configuración o mantenimiento adicional. Usa Enterprises.pullNotificationSet y Enterprises.acknowledgeNotificationSet para recibir y confirmar notificaciones de EMM a través de conexiones salientes de larga duración.

Cuando llames a Enterprises.pullNotificationSet, te recomendamos que dejes el requestMode en su valor predeterminado (waitForNotifications). Esto hace que la solicitud espere hasta que haya una o más notificaciones presentes antes de mostrar una respuesta. Si no hay notificaciones después de un tiempo, la solicitud muestra una lista de notificaciones vacía, después de la cual puedes volver a intentar la solicitud.

Después de recibir notificaciones, llama a Enterprises.acknowledgeNotificationSet para asegurarte de que no se muestren las mismas notificaciones la próxima vez que llames a Enterprises.pullNotificationSet.

También tienes la opción de establecer requestMode en returnImmediately cuando llamas a Enterprises.pullNotificationSet. Recibirás una respuesta a la solicitud de inmediato, que contendrá las notificaciones pendientes o una lista vacía si no hay notificaciones. Esta opción requestMode puede ser útil cuando pruebes inicialmente la implementación de tus notificaciones.

Ejemplos de notificaciones de EMM

Estos son algunos ejemplos de eventos y los tipos de notificaciones que generan:

Nota: Los siguientes tipos de notificaciones dejaron de estar disponibles: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent y NewDeviceEvent. Para AppUpdateEvent, debes usar el modo de actualización de alta prioridad según nuestras recomendaciones.

DescripciónNotificación
Se solicita una notificación de prueba a través de la API de EMM de Google Play. Debes enviar una notificación de prueba para confirmar que tu sistema puede recibir las notificaciones que publica Google Play y para conocer el nombre del tema que se usa para todas las notificaciones asociadas con Google Play. TestPushNotification
Un dispositivo aprovisionado recientemente está listo para que la API de EMM de Google Play lo administre. Ahora puedes llamar a las APIs que requieren el deviceId del dispositivo (por ejemplo, Installs) y a las APIs que muestran un recurso Devices. Esta notificación solo se envía después de que se aprovisiona la primera cuenta en un dispositivo administrado. OBSOLETO NewDeviceEvent
Un administrador marca una aplicación como aprobada o no aprobada en Google Play Console administrado. OBSOLETO ProductApprovalEvent
Se agota el tiempo de espera de una instalación pendiente en un dispositivo. Por ejemplo, se acepta una solicitud de instalación push, pero no se puede acceder al dispositivo durante varios días, por lo que no se puede confirmar la instalación. El sistema envía una notificación de tiempo de espera de instalación.InstallFailureEvent
Se publica una versión nueva de una app. La actualización está disponible para uno o más dispositivos, pero no necesariamente para todos. OBSOLETO AppUpdateEvent
Una actualización de app requiere que el administrador apruebe un nuevo permiso para que se pueda realizar una actualización o una instalación nueva. Esta notificación se envía cuando el conjunto de permisos aceptados de la aplicación difiere del conjunto de permisos solicitados. OBSOLETO NewPermissionsEvent
Se publica una versión nueva de una app que incluye un esquema de configuración administrada nuevo o modificado. Cuando un desarrollador carga un APK nuevo, Google Play compara el esquema del manifiesto con el esquema de la versión anterior de la app. Si el esquema cambió, notifica a las empresas que aprobaron la app. OBSOLETO AppRestrictionsSchemaChangeEvent
Una app disponible deja de estarlo o se vuelve a agregar a Google Play. La disponibilidad de la app cambia si un desarrollador anula su publicación o si se quita de Google Play. La disponibilidad también cambia si se vuelve a agregar a Google Play una app que no está disponible. OBSOLETO ProductAvailabilityChangeEvent
Una notificación relacionada con una actualización empresarial. Una actualización empresarial es un proceso que actualiza las cuentas empresariales de Google Play administrado a un dominio de Google administrado. EnterpriseUpgradeEvent