Übersicht

Die Nearby Messages API ist eine Publish/Subscribe-API, mit der Sie kleine binäre Nutzlasten zwischen mit dem Internet verbundenen Android- und iOS-Geräten übertragen können. Die Geräte müssen sich nicht im selben Netzwerk befinden, aber sie müssen mit dem Internet verbunden sein.

Nearby verwendet Bluetooth Low Energy, um einen einmaligen Kopplungscode zwischen Geräten zu übertragen. Der Server ermöglicht den Nachrichtenaustausch zwischen Geräten, die denselben Kopplungscode erkennen. Wenn ein Gerät einen Kopplungscode von einem Gerät in der Nähe erkennt, sendet es den Kopplungscode zur Validierung an den Nearby Messages-Server und prüft, ob Nachrichten für die aktuelle Gruppe von Abos der Anwendung bereitgestellt werden müssen.

Nearby Messages ist nicht authentifiziert und erfordert kein Google-Konto.

Der genaue Mechanismus für den Datenaustausch kann sich von Release zu Release unterscheiden. Die folgende Sequenz zeigt die Ereignisse, die zum Nachrichtenaustausch führen:

  1. Eine Veröffentlichungs-App sendet eine Anfrage, um eine binäre Nutzlast (die Nachricht) mit einem einmaligen Kopplungscode (Token) zu verknüpfen. Der Server stellt eine temporäre Verknüpfung zwischen der Nachrichtennutzlast und dem Token her.

  2. Das Veröffentlichungsgerät verwendet Bluetooth Low Energy, um das Token für Geräte in der Nähe erkennbar zu machen. Das Veröffentlichungsgerät verwendet auch Bluetooth Low Energy, um nach Tokens von anderen Geräten zu suchen.

  3. Eine Abo-App verknüpft ihr Abo mit einem Token und sendet ihr Token über Bluetooth Low Energy an den Publisher und erkennt das Token des Publishers.

  4. Wenn eine der beiden Seiten das Token der anderen erkennt, meldet sie es dem Server.

  5. Der Server ermöglicht den Nachrichtenaustausch zwischen zwei Geräten, wenn beide mit einem gemeinsamen Token verknüpft sind und die von den aufrufenden Apps verwendeten API-Schlüssel mit demselben Projekt in der Google Developers Console verknüpft sind.

Bei Verwendung des Google Play-Dienste-SDK für Geräte in der Nähe werden Nutzungsanalysen erhoben, um die Nutzerfreundlichkeit zu verbessern.

  • Leistungsmesswerte:Bei Verwendung des Nearby SDK werden die Dauer von Veröffentlichungen und Abos sowie die Anzahl der empfangenen Nachrichten erhoben.
  • Geräteinformationen:Das Gerätemodell, das Land, die Build-Version und der Paketname der Anwendung werden erhoben und mit den Leistungsmesswerten verknüpft, um regionale und gerätespezifische Segmente zu identifizieren.
  • Veröffentlichungen über Nearby Messages:Über Nearby Messages veröffentlichte Daten werden von Google gespeichert, bis die Nachricht nicht mehr veröffentlicht wird. Diese Daten werden mit Abonnenten geteilt, die sich in der Nähe des Geräts befinden.

Endnutzer können diese Erhebung zulassen oder ablehnen. Rufen Sie dazu die Einstellungen > Google > Nutzung und Diagnose auf.