Configura notificaciones de Pub/Sub

Nota: Los socios de EMM existentes con ESA creados de forma programática deben registrar su proyecto de Cloud preferido con Google antes de configurar notificaciones de Pub/Sub para la API de Android Management. Para obtener más información, consulta la Guía para socios de EMM existentes.

Las notificaciones de Pub/Sub te permiten recibir alertas sobre dispositivos recién inscritos, informes de dispositivos y comandos emitidos recientemente.

Para configurar 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 otorgarle permiso a la Política de dispositivos de Android para que publique en tu tema.

1. Habilita la API de Pub/Sub para tu proyecto

Para obtener instrucciones sobre cómo habilitar la API de Pub/Sub, consulta la guía de inicio rápido de Console. 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. De forma manual en la consola de Google Cloud.
b. Con la API de Pub/Sub (consulta el método para crear temas).

Después de crear un tema, toma nota del nombre.

3. Crea una suscripción

Una suscripción captura la transmisión de mensajes publicados a un tema específico. Existen dos maneras de crear una suscripción:

a. De forma manual en la consola de Google Cloud.
b. Con la API de Pub/Sub (consulta el método para crear suscripciones).

4. Otorga a Android Device Policy el derecho de publicar en tu tema

Debes otorgarle permiso a [e-mail] para publicar en tu tema. Existen dos maneras de otorgar derechos de publicación:

a. De forma manual en la consola de Google Cloud

• Agrega [e-mail] como miembro a tu tema.
• Haz clic en Selecciona un rol > Pub/Sub > Publicador de Pub/Sub.

b. Con la API de Pub/Sub (consulta Controla el acceso a través de la API de IAM)

• Agrega serviceAccount:[e-mail] a members.
• Establece role en roles/pubsub.publisher.

5. Actualiza la versión empresarial para admitir notificaciones

Omite este paso si la notificación que deseas admitir es ENTERPRISE_UPGRADE, que siempre es compatible.

Para conectar 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 en el formato projects/{project}/topics/{topic}.
• enabledNotificationTypes: Incluye todos los tipos de notificaciones que deseas recibir. Elige entre ENROLLMENT, STATUS_REPORT y COMMAND.

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. Los lineamientos y las instrucciones para recibir notificaciones a través de ambos mecanismos están disponibles en la Guía para suscriptores de Pub/Sub.

Formato de mensaje

Los mensajes tienen el formato 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 en JSON del recurso que se actualizó, codificada como una cadena UTF-8. Las notificaciones y sus tipos de recursos correspondientes son las 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 y STATUS_REPORT usan el tipo de recurso Device.
• Las notificaciones de ENTERPRISE_UPGRADE usan el tipo de recurso EnterpriseUpgradeEvent.

Cuando configures pubsubTopic en una empresa, se publicará un mensaje inicial con notificationType configurado en test. Este mensaje se envía para verificar que Android Device Policy tenga el permiso de publicación en el tema y se debe ignorar.

Nota: Cuando se usa la API de REST de Pub/Sub, el campo data se codifica como una cadena base64. Para obtener el JSON del recurso, primero realiza la decodificación de base64 en el contenido de data y, luego, interpreta los bytes resultantes como una cadena UTF-8.

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 integrado en el dispositivo y la notificación de EMM correspondiente^1
Estados de apps con claves de prioridad alta	Inmediato, un informe como máximo por minuto
Estados de apps con claves 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 TI^2	En 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 un plazo de 5 minutos
Eventos relacionados con la aplicación durante y después del aprovisionamiento, para apps con estados de instalación definidos por el empleado^3	En un plazo de 60 minutos
Otros eventos de apps en el dispositivo	En un plazo de 60 minutos

---

1. Objetivos del mejor esfuerzo basados en circunstancias controladas La latencia real puede variar según varios factores ambientales y del dispositivo. ↩

2. InstallType de apps aplicadas en la política: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED y KIOSK. ↩

3. InstallType de apps disponibles: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩