Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 sur le même réseau, mais ils doivent être connectés à Internet.
Nearby utilise le Bluetooth basse consommation pour communiquer un code d'association unique dans le temps 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 à partir d'un appareil à proximité, il l'envoie au serveur Nearby Messages pour validation et pour vérifier s'il existe des messages à envoyer pour l'ensemble actuel d'abonnements de l'application.
Les messages à proximité ne sont pas authentifiés et ne nécessitent 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 qui mènent à l'échange de messages:
Une application de publication envoie une requête pour associer une charge utile binaire (le message) à un code d'association unique dans le temps (jeton). Le serveur établit une association temporaire entre la charge utile du message et le jeton.
L'appareil émetteur utilise le Bluetooth à basse consommation pour rendre le jeton détectable par les appareils à proximité. L'appareil de publication utilise également le Bluetooth basse consommation pour rechercher des jetons provenant d'autres appareils.
Une application d'abonnement associe son abonnement à un jeton et utilise le Bluetooth à basse consommation pour envoyer son jeton à l'éditeur et pour détecter le jeton de l'éditeur.
Lorsqu'un des côtés détecte le jeton de l'autre, il le signale au serveur.
Le serveur facilite l'échange de messages entre deux appareils lorsqu'ils sont tous deux associés à un jeton commun et que les clés API utilisées par les applications appelantes sont associées au même projet dans la console pour les développeurs Google.
Lorsque vous utilisez le SDK Nearby des services Google Play, des données analytiques sur l'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 du build et le nom du package de l'application sont collectés et associés aux métriques de performances pour identifier les segments régionaux et spécifiques à l'appareil.
Nearby Messages publie: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 à proximité de l'appareil.
Les utilisateurs finaux peuvent autoriser ou refuser cette collecte en accédant à Paramètres > Google > Utilisation et diagnostics.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eNearby Messages, a publish-subscribe API, enables the exchange of small data payloads between nearby Android and iOS devices over the internet using Bluetooth Low Energy.\u003c/p\u003e\n"],["\u003cp\u003eThis API, set to be deprecated in December 2023, is unauthenticated, doesn't require a Google account, and leverages a unique pairing code system for device discovery and message delivery.\u003c/p\u003e\n"],["\u003cp\u003eGoogle collects performance metrics, device information, and published message data to improve the service; however, users can control this data collection through their device settings.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to migrate to Nearby Connections for continued support and functionality.\u003c/p\u003e\n"]]],[],null,["# Overview\n\n| **Warning:** Nearby Messages is deprecated and will stop working as of December 2023. Please migrate to [Nearby Connections](//developers.google.com/nearby/connections/overview) for further support.\n\nThe Nearby Messages API is a publish-subscribe API that lets you pass small\nbinary payloads between internet-connected Android and iOS devices. The devices\ndon't have to be on the same network, but they do have to be connected to the\nInternet.\n\nNearby uses Bluetooth Low Energy to communicate a unique-in-time pairing code\nbetween devices. The server facilitates message exchange between devices that\ndetect the same pairing code. When a device detects a pairing code from a nearby\ndevice, it sends the pairing code to the Nearby Messages server for validation,\nand to check whether there are any messages to deliver for the application's\ncurrent set of subscriptions.\n\nNearby Messages is unauthenticated and does not require a Google Account.\n\nThe exact mechanism for data exchange may vary from release to release. The\nfollowing sequence shows the events leading to message exchange:\n\n1. A publishing app makes a request to associate a binary payload (the message)\n with a unique-in-time pairing code (token). The server makes a temporary\n association between the message payload and the token.\n\n2. The publishing device uses Bluetooth Low Energy to make the token detectable\n by nearby devices. The publishing device also uses Bluetooth Low Energy to scan\n for tokens from other devices.\n\n3. A subscribing app associates its subscription with a token and uses Bluetooth\n Low Energy to send its token to the publisher, and to detect the publisher's\n token.\n\n4. When either side detects the other's token, it reports it to the server.\n\n5. The server facilitates message exchange between two devices when both are\n associated with a common token, and the API keys used by the calling apps are\n associated with the same project in the [Google Developers Console](https://console.developers.google.com/).\n\nWhen using the Google Play services Nearby SDK, usage analytics are collected to\nimprove the experience.\n\n- **Performance metrics:** The duration of publishes and subscriptions and the number of messages received is collected when using the Nearby SDK.\n- **Device information:** Device model, country, build version and the application package name are collected and associated with the performance metrics to identify regional and device-specific slices.\n- **Nearby Messages publishes:** Data published through Nearby Messages is stored by Google until the message is no longer published. This data is shared with subscribers who are near the device.\n\nEnd users can allow or deny this collection by navigating to Settings \\\u003e Google \\\u003e\nUsage \\& diagnostics."]]
