Habilitar notificaciones push de EMM

En esta guía, se da por sentado que ya tienes un ESA creado manualmente y se muestra y cómo configurarlo para usarlo con notificaciones push de EMM. Las tareas se completan por el propietario de la ESA (tú, como proveedor de soluciones de EMM o tu cliente) mediante la Consola de APIs de Google:

1. Habilitar el acceso a la API de Google Cloud Pub/Sub en la Consola de APIs de Google para un de Google Cloud.

2. Otorga permisos de editor a la ESA.

3. Configura un proyecto para recibir notificaciones de EMM.

4. Enviar una notificación de prueba de EMM

5. Suscríbete al tema.

Estos pasos se describen con más detalle en las siguientes secciones.

1. Habilita el acceso a la API de Cloud Pub/Sub para un proyecto

Para activar la API de Cloud Pub/Sub en tu proyecto, sigue estos pasos:

  1. En la Consola de APIs, abre la Biblioteca de APIs. Seleccionar el proyecto (o crear uno nuevo, si es necesario). La Biblioteca de APIs enumera todos disponibles, agrupadas por familia de productos y popularidad.
  2. En las APIs de Google Cloud, busca la API de Cloud Pub/Sub. (Si no es en la lista, usa la búsqueda para encontrarla).
  3. Selecciona API de Cloud Pub/Sub y, luego, haz clic en Habilitar.

Después de habilitar una API, en APIs & el menú Servicios, haz clic Dashboard para ver una lista de todas tus APIs habilitadas. Antes de la nube Puedes usar la API de Pub/Sub para enviar mensajes a tu cliente, debes otorgarle a Editor a la cuenta de servicio de ese cliente (su ESA).

2. Otorga permisos de editor a la ESA

En la Consola de APIs, otorga los permisos necesarios:

  1. Desde la Herramienta de APIs y el menú Servicios, haz clic en Credenciales. Deberías puede ver la ESA de su cliente en Claves de cuenta de servicio.
  2. Haz clic en Administrar cuentas de servicio para abrir todas las cuentas de servicio. asociados con el proyecto.
  3. De la lista, selecciona la cuenta de ESA correspondiente y haz clic en Permisos:
  4. En el campo Agregar miembros, haz lo siguiente:
    • Ingresa la dirección de correo electrónico asociada con la ESA.
    • En el selector desplegable, elige Editor (junto al campo de entrada).
  5. Haz clic en Add para guardar los permisos.

3. Configura un proyecto para recibir notificaciones de EMM

Con la API de Cloud Pub/Sub habilitada y una ESA configurada con Editor permisos, puedes configurar un proyecto para que reciba notificaciones de EMM como se detallan en Establecer las notificaciones push de EMM. En pocas palabras, el proceso de configuración implica configurar un extremo de servidor HTTP para enviar notificaciones push a los suscriptores.

Las notificaciones de EMM se entregan como protobufs (búferes de protocolo, un formato simple para serializar datos estructurados) empaquetados como mensajes de array de bytes con codificación byte64 dentro de paquetes JSON. En tu código, debes analizar este JSON y decodificar el contenido del búfer de protocolo. Este es un ejemplo de un protobuf codificado y seguro para URL en base64 para un NewPermissionsEvent notificación:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Se decodifica en:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

Para decodificar las notificaciones de EMM con formato protobuf, puedes usar el emm_pubsub.proto archivo ubicado en el google/play-work en GitHub. Cuando los nuevos tipos de notificaciones agregado, ese archivo se extiende con el nuevo tipo y el código de muestra se actualiza. Estos cambios deberían ser retrocompatibles, pero asegúrate de que tu código pueda adaptarse con elegancia al recibir notificaciones de tipos desconocidos además de aquellas enumeradas en el archivo .proto.

4. Enviar una notificación de prueba de EMM

Si envías una notificación de prueba, podrás confirmar que realizaste correctamente la acción. configurar tu sistema para recibir notificaciones de EMM de Google Play también te permite conocer el nombre del tema (se usa el mismo nombre para enviar todas las notificaciones de EMM de Google Play).

Con la API de EMM de Play, llama al método sendTestPushNotification en el recurso Enterprises.

Invocar esta operación hace que se envíe una notificación de EMM de prueba. Si es EMM si las notificaciones están configuradas correctamente, la API muestra lo siguiente:

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

5. Suscribirse al tema

Con el código de muestra proporcionado en Cómo ejecutar el código de prueba del publicador (en el vínculo Configura el envío de EMM de Google Ads), suscríbete al tema especificado. Deberías recibir la notificación de prueba de EMM, junto con cualquier notificación real desde que comenzaste el proceso de configuración.