Las notificaciones de Pub/Sub te permiten recibir alertas sobre dispositivos recién inscritos, informes de dispositivos y comandos emitidos recientemente.
Para configurar las notificaciones de Pub/Sub, debes habilitar la API de Pub/Sub y crear un tema. Para recibir mensajes publicados en un tema, crea una suscripción a ese tema. La suscripción conecta el tema a una aplicación de suscriptor que recibe y procesa los mensajes publicados en el tema. Después de crear una suscripción, debes otorgar permiso a Android Device Policy para publicar en tu tema.
1. Habilita la API de Pub/Sub para tu proyecto
Si quieres obtener instrucciones para habilitar la API de Pub/Sub, consulta la guía de inicio rápido de la consola. Asegúrate de seleccionar el mismo proyecto para el que está habilitada la API de Android Management.
2. Crea un tema
Después de habilitar la API, debes crear un tema en el que Android Device Policy pueda publicar notificaciones. Existen dos formas de crear un tema:
a. Manualmente en la consola de Google Cloud.
b. Usar la API de Pub/Sub (consulta el método create topic)
Después de crear un tema, anota su nombre.
3. Crea una suscripción
Una suscripción captura la transmisión de mensajes publicados a un tema específico. Existen dos formas de crear una suscripción:
a. Manualmente en la consola de Google Cloud.
b. Con la API de Pub/Sub (consulta el método create subscription)
4. Otorga a Android Device Policy el derecho de publicar en tu tema
Debes otorgarle permiso a android-cloud-policy@system.gserviceaccount.com para publicar en tu tema. Existen dos formas de otorgar derechos de publicación:
a. Manualmente en la consola de Google Cloud
- Agrega android-cloud-policy@system.gserviceaccount.com como miembro a tu tema.
- Haz clic en Selecciona un rol > Pub/Sub > Publicador de Pub/Sub.
b. Usa la API de Pub/Sub (consulta Controla el acceso a través de la API de IAM).
- Se agregó
serviceAccount:android-cloud-policy@system.gserviceaccount.com
amembers
. - Establece
role
enroles/pubsub.publisher
.
5. Actualiza la empresa para admitir notificaciones
Omite este paso si la notificación que deseas admitir es ENTERPRISE_UPGRADE
, que siempre se admite.
Para conectar las notificaciones sobre una empresa al tema que creaste, llama a enterprises.patch
y especifica los siguientes parámetros:
pubsubTopic
: Es el nombre de tu tema de Pub/Sub con el formatoprojects/{project}/topics/{topic}
.enabledNotificationTypes
: Incluye todos los tipos de notificaciones que deseas recibir.
6. Usa la API de Pub/Sub para recibir notificaciones
Una suscripción puede usar el mecanismo de extracción o de envío para la entrega de mensajes. En la Guía sobre suscriptores de Pub/Sub, se encuentran disponibles los lineamientos y las instrucciones para recibir notificaciones a través de ambos mecanismos.
Formato de mensaje
Los mensajes tienen la forma de un PubsubMessage.
El campo attributes
del mensaje contiene un atributo con la clave notificationType
y el valor establecido en el tipo de notificación que activó el mensaje (p.ej., ENROLLMENT
). El campo data
del mensaje contiene la representación JSON del recurso que se actualizó, codificada como una cadena UTF-8. Las notificaciones y sus tipos de recursos correspondientes son los siguientes:
- Las notificaciones de
COMMAND
usan el tipo de recurso Operation. - Las notificaciones de
USAGE_LOGS
usan el tipo de recurso UsageLogEvent. - Las notificaciones
ENROLLMENT
ySTATUS_REPORT
usan el tipo de recurso Device. - Las notificaciones de
ENTERPRISE_UPGRADE
usan el tipo de recurso EnterpriseUpgradeEvent.
Cuando se configura el pubsubTopic
en una empresa, se publica un mensaje inicial con notificationType
establecido en test
. Este mensaje se envía para verificar que Android Device Policy tenga permiso de publicación en el tema y se debe ignorar.
Latencia esperada
Se espera que los eventos de actualización de Enterprise se envíen de inmediato.
Los eventos de dispositivos locales que ocurren en rápida sucesión se agrupan y se informan en un solo mensaje de Pub/Sub a los EMM.
Tipo de evento | Latencia esperada entre el evento en el dispositivo y la notificación del EMM correspondiente1 |
---|---|
Estados de la app con clave de prioridad alta | Inmediato, como máximo un informe por minuto |
Estados de la app con clave de prioridad estándar | En un minuto |
Eventos relacionados con la aplicación durante el aprovisionamiento, para apps con estados de instalación definidos por el administrador de TI2 | En el plazo de un minuto, además de otros eventos de aprovisionamiento relacionados |
Eventos relacionados con la aplicación después del aprovisionamiento, para apps con estados de instalación definidos por el administrador de TI. | En 5 minutos |
Eventos relacionados con la aplicación durante el aprovisionamiento y después de este, para las apps con estados de instalación definidos por el empleado3 | En un plazo de 60 minutos |
Otros eventos de la app en el dispositivo | En un plazo de 60 minutos |
-
Objetivos basados en el mejor esfuerzo en circunstancias controladas. La latencia real puede variar según diversos factores ambientales y del dispositivo. ↩
-
InstallType
de apps que se aplican en la política:FORCE_INSTALLED
,BLOCKED
,REQUIRED_FOR_SETUP
,PREINSTALLED
yKIOSK
. ↩ -
InstallType
de apps disponibles:AVAILABLE
,INSTALL_TYPE_UNSPECIFIED
. ↩