概要

Nearby Messages API は、インターネットに接続された Android デバイスと iOS デバイス間で小さなバイナリ ペイロードを渡せる、パブリッシュ / サブスクライブ API です。デバイスは同じネットワーク上にある必要はありませんが、インターネットに接続する必要があります。

Nearby は Bluetooth Low Energy を使用して、デバイス間で一意の時間内ペア設定コードを通信します。サーバーにより、同じペア設定コードを検出したデバイス間のメッセージ交換が容易になります。付近のデバイスからペア設定コードを検出すると、デバイスはそのペア設定コードを Nearby Messages サーバーに送信して検証し、アプリの現在のサブスクリプション セットに配信するメッセージがあるかどうかを確認します。

Nearby Messages は認証されていないため、Google アカウントは必要ありません。

データ交換の正確なメカニズムは、リリースごとに異なる場合があります。次のシーケンスは、メッセージ交換につながるイベントを示しています。

  1. 公開用アプリが、バイナリ ペイロード(メッセージ)を一意の時間内ペアリングコード(トークン)に関連付けるリクエストを行います。サーバーは、メッセージ ペイロードとトークンの間に一時的な関連付けを行います。

  2. 公開デバイスは Bluetooth Low Energy を使用して、付近のデバイスでトークンを検出可能にします。また、公開デバイスは Bluetooth Low Energy を使用して、他のデバイスからのトークンをスキャンします。

  3. サブスクライブするアプリは、購読をトークンに関連付け、Bluetooth Low Energy を使用してトークンをニュース メディアに送信し、ニュース メディアのトークンを検出します。

  4. どちらか一方がもう一方のトークンを検出すると、サーバーに報告します。

  5. 2 つのデバイスの両方が共通のトークンに関連付けられており、呼び出し元アプリが使用する API キーが Google Developers Console の同じプロジェクトに関連付けられている場合、サーバーは 2 つのデバイス間でのメッセージ交換を容易にします。

Google Play 開発者サービスの Nearby SDK を使用する場合、エクスペリエンス向上のために使用状況の分析が収集されます。

  • パフォーマンス指標: Nearby SDK の使用時には、パブリッシュとサブスクリプションの期間、受信したメッセージの数が収集されます。
  • デバイス情報: リージョンおよびデバイス固有のスライスを識別するために、デバイスモデル、国、ビルド バージョン、アプリのパッケージ名が収集され、パフォーマンス指標に関連付けられます。
  • Nearby Messages の公開: Nearby Messages で公開されたデータは、メッセージが公開されなくなるまで Google によって保存されます。このデータは、デバイスの近くにいるサブスクライバーと共有されます。

エンドユーザーは、[設定] > [Google] > [使用状況と診断情報] に移動して、この収集を許可または拒否できます。