Descripción general

La API de Nearby Messages es una API de publicación y suscripción que te permite pasar pequeñas cargas útiles binarias entre dispositivos iOS y Android conectados a Internet. No es necesario que los dispositivos estén en la misma red, pero sí deben estar conectados a Internet.

Nearby usa Bluetooth de bajo consumo para comunicar un código de vinculación único en el tiempo entre dispositivos. El servidor facilita el intercambio de mensajes entre los dispositivos que detectan el mismo código de vinculación. Cuando un dispositivo detecta un código de vinculación de un dispositivo cercano, envía el código de vinculación al servidor de Mensajes cercanos para su validación y para verificar si hay mensajes que entregar para el conjunto actual de suscripciones de la aplicación.

La API de Nearby Messages no está autenticada y no requiere una Cuenta de Google.

El mecanismo exacto para el intercambio de datos puede variar de una versión a otra. En la siguiente secuencia, se muestran los eventos que conducen al intercambio de mensajes:

  1. Una app de publicación realiza una solicitud para asociar una carga útil binaria (el mensaje) con un código de vinculación único en el tiempo (token). El servidor realiza una asociación temporal entre la carga útil del mensaje y el token.

  2. El dispositivo de publicación usa Bluetooth de bajo consumo para que los dispositivos cercanos puedan detectar el token. El dispositivo que publica también usa Bluetooth de bajo consumo para buscar tokens de otros dispositivos.

  3. Una app con suscripción asocia su suscripción con un token y usa Bluetooth de bajo consumo para enviar su token al publicador y detectar el token del publicador.

  4. Cuando cualquiera de los lados detecta el token del otro, lo informa al servidor.

  5. El servidor facilita el intercambio de mensajes entre dos dispositivos cuando ambos están asociados con un token común y las claves de API que usan las apps de llamadas están asociadas con el mismo proyecto en la consola de Google Developers.

Cuando usas el SDK de Nearby de los Servicios de Google Play, se recopilan estadísticas de uso para mejorar la experiencia.

  • Métricas de rendimiento: Cuando se usa el SDK de Nearby, se recopila la duración de las publicaciones y las suscripciones, y la cantidad de mensajes recibidos.
  • Información del dispositivo: El modelo del dispositivo, el país, la versión de compilación y el nombre del paquete de la aplicación se recopilan y asocian con las métricas de rendimiento para identificar porciones regionales y específicas del dispositivo.
  • Publicaciones de Mensajes cercanos: Google almacena los datos publicados a través de Mensajes cercanos hasta que el mensaje deja de publicarse. Estos datos se comparten con los suscriptores que están cerca del dispositivo.

Los usuarios finales pueden permitir o rechazar esta recopilación en Configuración > Google > Uso y diagnóstico.