Informações gerais

A API Nearby Messages é uma API de publicação/assinatura que permite transmitir pequenos payloads binários entre dispositivos Android e iOS conectados à Internet. Os dispositivos não precisam estar na mesma rede, mas precisam estar conectados à Internet.

O Nearby usa o Bluetooth Low Energy para comunicar um código de pareamento em tempo único entre dispositivos. O servidor facilita a troca de mensagens entre dispositivos que detectam o mesmo código de pareamento. Quando um dispositivo detecta um código de pareamento de um dispositivo próximo, ele o envia ao servidor do Nearby Messages para validação e para verificar se há alguma mensagem a ser entregue para o conjunto atual de assinaturas do aplicativo.

O Nearby Messages não é autenticado e não requer uma Conta do Google.

O mecanismo exato para a troca de dados pode variar de acordo com a versão. A sequência a seguir mostra os eventos que levam à troca de mensagens:

  1. Um app de publicação faz uma solicitação para associar um payload binário (a mensagem) a um código de pareamento (token) em tempo único. O servidor faz uma associação temporária entre o payload da mensagem e o token.

  2. O dispositivo de publicação usa o Bluetooth Low Energy para tornar o token detectável por dispositivos próximos. O dispositivo de publicação também usa o Bluetooth Low Energy para procurar tokens de outros dispositivos.

  3. Um app assinante associa a assinatura a um token e usa o Bluetooth Low Energy para enviar o token ao editor e detectá-lo.

  4. Quando um dos lados detecta o token do outro, ele o informa ao servidor.

  5. O servidor facilita a troca de mensagens entre dois dispositivos quando ambos estão associados a um token comum, e as chaves de API usadas pelos apps de chamada estão associadas ao mesmo projeto no Google Developers Console.

Ao usar o SDK do Nearby do Google Play Services, as análises de uso são coletadas para melhorar a experiência.

  • Métricas de desempenho:a duração das publicações e assinaturas e o número de mensagens recebidas são coletados ao usar o SDK do Nearby.
  • Informações do dispositivo:o modelo do dispositivo, o país, a versão do build e o nome do pacote do app são coletados e associados às métricas de desempenho para identificar frações regionais e específicas do dispositivo.
  • Publicação do Nearby Messages: os dados publicados pelo Nearby Messages são armazenados pelo Google até que a mensagem não seja mais publicada. Esses dados são compartilhados com os assinantes que estão próximos ao dispositivo.

Os usuários finais podem permitir ou negar essa coleta acessando Configurações > Google > Uso e diagnósticos.