Instance ID API を使用すると、Instance ID を Android アプリまたは iOS アプリに統合できます。Instance ID は、アプリの各インスタンスに一意の識別子と、アクションを認証して承認するメカニズムを提供します。InstanceID
は有効期間が長いですが、次の理由で期限切れになることがあります。
- デバイスを出荷時の設定にリセットします。
- ユーザーがアプリをアンインストールします。
- ユーザーがアプリで [データを消去] を実行した場合。
- デバイスが長期間使用されていない(デバイスと地域によって期間が異なります)。
- Instance ID サービスが不正使用またはエラーを検出し、
InstanceID
をリセットします。 - クライアント アプリでその機能が必要な場合のサーバーサイド コード。
Instance ID サービスは、InstanceIDListenerService
へのコールバックを介して、InstanceID
のリセットをアプリに通知します。アプリがこの通知を受け取った場合は、getToken()
を呼び出して新しい InstanceID
を取得し、サーバーを更新する必要があります。
getToken
メソッドを使用して InstanceID
の所有権を証明し、サーバーがアプリに関連付けられたデータやサービスにアクセスできるようにします。このメソッドは OAuth2 のパターンに従い、authorizedEntity
と scope
が必要です。authorizedEntity
はプロジェクト ID または別の InstanceID
にすることができ、生成されたトークンの使用が承認されるサービスを決定します。scope
は、トークンがアクセスを許可する特定のサービスまたはデータを決定します。
Instance ID API の詳細については、以下をご覧ください。