Überblick

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 mit dem Internet.

Nearby verwendet Bluetooth Low Energy, um einen einmaligen Kopplungscode zwischen Geräten zu kommunizieren. Der Server erleichtert 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 für die aktuellen Abos der Anwendung Nachrichten zu übermitteln sind.

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

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

  1. Eine veröffentlichende Anwendung sendet eine Anfrage, um eine binäre Nutzlast (die Nachricht) mit einem einmaligen Kopplungscode (Token) zu verknüpfen. Der Server stellt eine temporäre Zuordnung zwischen der Nachrichtennutzlast und dem Token her.

  2. Das veröffentlichende Gerät verwendet Bluetooth Low Energy, um das Token von Geräten in der Nähe sichtbar zu machen. Das 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, wird es an den Server gemeldet.

  5. Der Server erleichtert 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.

Wenn Sie das Nearby SDK der Google Play-Dienste verwenden, werden Nutzungsanalysen erhoben, 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:Das Gerätemodell, das Land, die Build-Version und der Name des Anwendungspakets werden erfasst und mit den Leistungsmesswerten verknüpft, um regionale und gerätespezifische Segmente zu ermitteln.
  • Nearby Messages veröffentlicht:Ü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 die Erhebung dieser Daten zulassen oder ablehnen, indem sie „Einstellungen“ > „Google“ > „Nutzung & Diagnose“ aufrufen.