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 están asociadas con una cuenta de servicio empresarial (ESA) específica. Como EMM, puedes configurar tu consola para que muestre alertas o mensajes a los administradores de TI empresariales en función de las notificaciones que recibes.

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

Si deseas 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 necesitas conectar tu suscripción, llama a Enterprises.sendTestPushNotification.

El envío de una notificación de prueba valida tu integración de 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"
    }

Extraer notificaciones

Google Cloud Pub/Sub admite dos mecanismos de notificaciones diferentes: extracción y envío. 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 manual y programática. Otra ventaja de las notificaciones de extracción es que requieren poca o ninguna configuración o mantenimiento adicional por parte de tus clientes. Usa Enterprises.pullNotificationSet y Enterprises.acknowledgeNotificationSet para recibir y confirmar notificaciones de EMM sobre conexiones salientes de larga duración.

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

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 configurar requestMode en returnImmediately cuando se llama a Enterprises.pullNotificationSet. De inmediato, recibirás una respuesta a la solicitud, con las notificaciones pendientes o una lista vacía si no hay notificaciones presentes. Esta opción requestMode puede ser útil cuando pruebas inicialmente la implementación de 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 prioridad alta 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 pueda recibir las notificaciones que publica Google Play y conocer el nombre del tema que se usa para todas las notificaciones asociadas con Google Play. TestPushNotification
Un dispositivo recién aprovisionado está listo para ser administrado por la API de EMM de Google Play. Ahora puedes llamar a las APIs que requieren el deviceId del dispositivo (por ejemplo, las instalaciones) y a las APIs que muestran un recurso de dispositivos. Esta notificación solo se envía después de que la primera cuenta se aprovisiona 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 la instalación.InstallFailureEvent
Cuando se publica una nueva versión 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 la app requiere un permiso nuevo para que el administrador lo apruebe para que se pueda ejecutar 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 de la aplicación. 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 sube un APK nuevo, Google Play compara el esquema del manifiesto con el de la versión anterior de la app. Si el esquema cambió, notifica a las empresas que aprobaron la app. OBSOLETA AppRestrictionsSchemaChangeEvent
Una app disponible deja de estar disponible o una app que no está disponible se vuelve a agregar a Google Play. La disponibilidad de la app cambia si un desarrollador anula la publicación o si se quita de Google Play. La disponibilidad también cambia si se vuelve a agregar una app no disponible a Google Play. OBSOLETO ProductAvailabilityChangeEvent