インスタンス ID API

Instance ID API を使用すると、インスタンス ID を Android アプリまたは iOS アプリと統合できます。インスタンス ID は、アプリの各インスタンスの一意の識別子と、アクションの認証と認可のメカニズムを提供します。InstanceID は有効期間が長いですが、次の理由で期限切れになる場合があります。

  • デバイスを出荷時設定にリセットする。
  • ユーザーがアプリをアンインストールする。
  • アプリで [データの消去] を実行します。
  • 長期間使用されなかったデバイス(期間はデバイスとリージョンによって決まります)。
  • インスタンス ID サービスが不正行為やエラーを検出し、InstanceID をリセットします。
  • サーバーサイドのコード(クライアント アプリでその機能が必要な場合)。

インスタンス ID サービスは、InstanceIDListenerService へのコールバックを介して、InstanceID のリセットをアプリに通知します。この通知を受け取ったアプリは、getToken() を呼び出して新しい InstanceID を取得し、サーバーを更新する必要があります。

getToken メソッドを使用して、InstanceID の所有権を証明し、アプリに関連付けられたデータまたはサービスにサーバーがアクセスできるようにします。このメソッドは OAuth2 のパターンに従い、authorizedEntityscope が必要です。authorizedEntity にはプロジェクト ID または別の InstanceID を指定できます。これにより、生成されたトークンの使用が許可されているサービスが決まります。scope により、トークンでアクセスを許可する特定のサービスまたはデータが決まります。

インスタンス ID API の詳細:

Android  iOS  サーバー