Übersicht

Die Nearby Messages API ist eine Publish-Subscribe-API, mit der du kleine binäre Nutzlasten zwischen mit dem Internet verbundenen Android- und iOS-Geräten übertragen kannst. 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 senden. 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 aktuellen Abos der Anwendung zu senden sind.

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

Der genaue Mechanismus für den Datenaustausch kann bei jedem Release variieren. In der folgenden Reihenfolge sind die Ereignisse aufgeführt, die zum Nachrichtenaustausch führen:

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

  2. Das Publishing-Gerät verwendet Bluetooth Low Energy, damit das Token von Geräten in der Nähe erkannt werden kann. Das Publishing-Gerät verwendet außerdem Bluetooth Low Energy, um nach Tokens von anderen Geräten zu suchen.

  3. Eine abonnierende App verknüpft ihr Abo mit einem Token und verwendet Bluetooth Low Energy, um ihr Token an den Verlag oder Webpublisher zu senden und das Token des Verlags oder Webpublishers zu erkennen.

  4. Wenn eine Seite das Token der anderen Seite erkennt, meldet es es an den 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 demselben Projekt in der Google Developers Console zugeordnet sind.

Bei Verwendung des Nearby SDK der Google Play-Dienste werden Nutzungsanalysen erfasst, um die Nutzung zu verbessern.

  • Leistungsmesswerte:Bei Verwendung des Nearby SDK werden die Dauer von Veröffentlichungen und Abos sowie die Anzahl der empfangenen Nachrichten erfasst.
  • Geräteinformationen:Gerätemodell, Land, Build-Version und Name des Anwendungspakets werden erfasst und den Leistungsmesswerten zugeordnet, um regionale und gerätespezifische Segmente zu identifizieren.
  • Nearby Messages-Veröffentlichungen:Daten, die über Nearby Messages veröffentlicht werden, 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 die Erhebung dieser Daten unter „Einstellungen“ > „Google“ > „Nutzung & Diagnose“ zulassen oder ablehnen.