Présentation

L'API Nearby Messages est une API de publication/abonnement qui vous permet de transmettre de petites charges utiles binaires entre des appareils Android et iOS connectés à Internet. Les appareils ne doivent pas nécessairement être connectés au même réseau, mais doivent être connectés à Internet.

La fonctionnalité À proximité utilise la technologie Bluetooth à basse consommation pour communiquer un code d'association unique entre les appareils. Le serveur facilite l'échange de messages entre les appareils qui détectent le même code d'association. Lorsqu'un appareil détecte un code d'association d'un appareil à proximité, il l'envoie au serveur Nearby Messages pour validation et pour vérifier s'il y a des messages à distribuer pour l'ensemble d'abonnements actuel de l'application.

Nearby Messages n'est pas authentifié et ne nécessite pas de compte Google.

Le mécanisme exact d'échange de données peut varier d'une version à l'autre. La séquence suivante montre les événements conduisant à l'échange de messages:

  1. Une application publiante envoie une requête pour associer une charge utile binaire (le message) à un code d'association unique dans le temps (jeton). Le serveur crée une association temporaire entre la charge utile du message et le jeton.

  2. L'appareil de publication utilise la technologie Bluetooth à basse consommation pour rendre le jeton détectable par les appareils à proximité. L'appareil de publication utilise également la technologie Bluetooth à basse consommation pour rechercher les jetons d'autres appareils.

  3. Une application d'abonnement associe son abonnement à un jeton et utilise la technologie Bluetooth à basse consommation pour envoyer son jeton à l'éditeur et détecter son jeton.

  4. Lorsque chaque côté détecte le jeton de l'autre, il le signale au serveur.

  5. Le serveur facilite l'échange de messages entre deux appareils lorsqu'ils sont tous deux associés à un jeton commun. Par ailleurs, les clés API utilisées par les applications appelantes sont associées au même projet dans la Google Developers Console.

Lorsque vous utilisez le SDK à proximité des services Google Play, des analyses d'utilisation sont collectées pour améliorer l'expérience.

  • Métriques de performances:la durée des publications et des abonnements, ainsi que le nombre de messages reçus, sont collectés lorsque vous utilisez le SDK Nearby.
  • Informations sur l'appareil:le modèle de l'appareil, le pays, la version de build et le nom du package de l'application sont collectés et associés aux métriques de performances pour identifier des tranches régionales et spécifiques à l'appareil.
  • Publication de Nearby Messages:les données publiées via Nearby Messages sont stockées par Google jusqu'à ce que le message ne soit plus publié. Ces données sont partagées avec les abonnés qui se trouvent à proximité de l'appareil.

Les utilisateurs finaux peuvent autoriser ou refuser cette collecte en accédant à Paramètres > Google > Utilisation et diagnostics.