Firebase で AI 搭載アプリを構築して実行する方法のデモを、2024 年の Demo Day でご覧ください。ぜひご覧ください。

メールアクションで状態を渡す

パスワードの再設定や、ユーザーのメールアドレスを確認する目的でメールアクションを送信するときに、続行 URL を使用して状態を渡すことができます。これにより、ユーザーはアクションの完了後にアプリに戻れるようになります。また、モバイルアプリがインストールされている場合に、ウェブページではなくモバイルアプリからメールアクションリンクが直接処理されるようにデベロッパー側で指定することも可能です。

これは、次の一般的に起こるシナリオで非常に役立ちます。

現在ログインしていないユーザーがログインの必要なコンテンツにアクセスしようとしているが、パスワードを忘れたため、パスワードを再設定するフローをトリガーする場合。ユーザーはこのフローの終了後、元々アクセスしようとしていたアプリのセクションに戻ることを期待しています。
確認済みのアカウントにしかアクセスを許可しないアプリの場合。たとえば、ニュースレターの登録では、ユーザーにメールアドレスの確認を求めます。ユーザーはメール確認フローを処理した後に、アプリに戻って登録を完了できることを期待しています。
その他、ユーザーがモバイルデバイスからフローを開始した場合。ユーザーはフローの確認後、ブラウザではなくモバイルアプリに戻ることを期待しています。

続行 URL を使用して状態を受け渡せる Firebase Auth の強力な機能により、ユーザーエクスペリエンスを大幅に向上させることができます。

メールアクションで状態 / 続行 URL を渡す

続行 URL を安全に渡すには、URL のドメインが Firebase コンソールで許可リストに登録されている必要があります。それには、[Authentication] セクションで、[ログイン方法] タブの下にある [承認済みドメイン] のリストにこのドメインを追加します（まだ存在しない場合）。

パスワードの再設定メールまたは確認メールを送信する際は、ActionCodeSettings インスタンスを指定する必要があります。このインスタンスは、関連する ActionCodeSettings.Builder クラスを使用して作成できます。このクラスには次のメソッドが含まれます。

メソッド	説明
`setUrl(String url)`	コンテキストによって異なる意味を持つリンク（状態 / 続行 URL）を設定します。リンクがウェブアクションウィジェットで処理される場合、これは `continueUrl` クエリパラメータのディープリンクを表します。リンクがアプリ内で直接処理される場合、これはダイナミックリンクのディープリンク内の `continueUrl` クエリパラメータを表します。
`setIOSBundleId(String iOSBundleId)`	iOS バンドル ID を設定します。これにより、iOS アプリがインストールされていれば、そのアプリでリンクを開くことを試みます。この iOS アプリはコンソールに登録されている必要があります。
`setAndroidPackageName(String androidPackageName, boolean installIfNotAvailable, String minimumVersion)`	Android パッケージ名を設定します。これにより、Android アプリがインストールされていれば、そのアプリでリンクを開くことを試みます。installIfNotAvailable を `true` に設定すると、Android アプリがサポートされるデバイスに Android アプリがまだインストールされていない場合に、Android アプリをインストールするかどうかが指定されます。minimumVersion を指定した場合、古いバージョンのアプリがインストールされているデバイスのユーザーは Play ストアにリダイレクトされ、アプリのアップグレードを促されます。この Android アプリはコンソールに登録されている必要があります。
`setHandleCodeInApp(boolean status)`	メールアクションリンクがモバイルアプリとウェブリンクのどちらで最初に開かれるかを示します。デフォルトは false です。true に設定すると、アクションコードリンクはユニバーサルリンクまたは Android アプリリンクとして送信され、アプリがインストールされている場合はそのアプリで開かれます。false の場合、コードは最初にウェブウィジェットに送信され、続いてアプリがインストールされている場合はそのアプリにリダイレクトされます。
`setDynamicLinkDomain(String dynamicLinkDomain)`	Firebase Dynamic Links を使用してリンクを開く場合は、現在のリンクに使用するダイナミックリンクドメイン（またはサブドメイン）を設定します。プロジェクトごとに複数のダイナミックリンクドメインを構成できるため、このフィールドでドメインを明示的に選択できます。指定しない場合、デフォルトで最初のドメインが使用されます。

次の例は、モバイルアプリで最初に Firebase ダイナミックリンク（iOS アプリでは com.example.ios または Android アプリでは com.example.android）として開かれるメール確認リンクを送信する方法を示しています。ディープリンクには、続行 URL ペイロード https://www.example.com/?email=user@example.com が含まれています。

Kotlin

val auth = Firebase.auth
val user = auth.currentUser!!

val url = "http://www.example.com/verify?uid=" + user.uid
val actionCodeSettings = ActionCodeSettings.newBuilder()
    .setUrl(url)
    .setIOSBundleId("com.example.ios")
    // The default for this is populated with the current android package name.
    .setAndroidPackageName("com.example.android", false, null)
    .build()

user.sendEmailVerification(actionCodeSettings)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }
MainActivity.kt

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
FirebaseUser user = auth.getCurrentUser();

String url = "http://www.example.com/verify?uid=" + user.getUid();
ActionCodeSettings actionCodeSettings = ActionCodeSettings.newBuilder()
        .setUrl(url)
        .setIOSBundleId("com.example.ios")
        // The default for this is populated with the current android package name.
        .setAndroidPackageName("com.example.android", false, null)
        .build();

user.sendEmailVerification(actionCodeSettings)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });
MainActivity.java

Firebase Dynamic Links を構成する

Firebase Auth では、モバイルアプリで開かれるリンクを送信するときに Firebase Dynamic Links が使用されます。この機能を使用するには、Firebase コンソールで Dynamic Links を構成する必要があります。

Firebase Dynamic Links を有効にする方法:
1. Firebase コンソールで、[Dynamic Links] セクションを開きます。
2. Dynamic Links の利用規約への同意と Dynamic Links のドメインの作成がまだの場合は、この時点でその作業を行います。
  
  Dynamic Links のドメインが作成済みである場合は、それをメモしておきます。Dynamic Links ドメインは、通常、次の例のようになります。
```
example.page.link
```
  受信リンクをインターセプトするように Apple アプリまたは Android アプリを構成するときに、この値が必要になります。
Android アプリを構成します。
1. Android アプリでこれらのリンクを処理する予定の場合は、Firebase コンソールのプロジェクト設定で Android パッケージ名を指定する必要があります。それに加えて、アプリ証明書の SHA-1 および SHA-256 を指定する必要があります。
2. AndroidManifest.xml ファイルで、ディープリンクのインテントフィルタを構成する必要があります。
3. 詳しくは、Android Dynamic Links の受信の手順をご覧ください。
iOS アプリを構成します。
1. iOS アプリでこれらのリンクを処理する予定の場合は、Firebase コンソールのプロジェクト設定で iOS バンドル ID を指定する必要があります。それに加えて、App Store ID と Apple デベロッパーチーム ID を指定する必要があります。
2. FDL ユニバーサルリンクドメインをアプリ機能の関連ドメインとして構成する必要があります。
3. アプリを iOS バージョン 8 以下に配布する予定がある場合は、iOS バンドル ID を受信 URL のカスタムスキームとして設定する必要があります。
4. 詳しくは、iOS Dynamic Links の受信の手順をご覧ください。

ウェブアプリケーションでメールアクションを処理する

最初にウェブアプリケーションでアクションコードリンクを処理し、正常に完了した後で別のウェブページまたはモバイルアプリ（使用可能な場合）にリダイレクトするかどうかを指定できます。これは、ActionCodeSettings.Builder オブジェクト内で setHandleCodeInApp(false) を呼び出すことで行われます。iOS バンドル ID または Android パッケージ名は必須ではありませんが、指定すると、メールアクションコードの完了時に、指定されたアプリにユーザーをリダイレクトできます。

ここで使用されるウェブ URL は、メールアクションテンプレートのセクションで構成された URL です。デフォルトの URL がすべてのプロジェクトにプロビジョニングされます。メールアクションハンドラをカスタマイズする方法について詳しくは、メールハンドラのカスタマイズをご覧ください。

この場合、continueUrl クエリパラメータ内のリンクは、ActionCodeSettings オブジェクトで指定された URL がペイロードに含まれる FDL リンクになります。アプリからの受信リンクは、他の依存関係なしでもインターセプトして処理できますが、FDL クライアントライブラリを使用してディープリンクを解析することをおすすめします。

メール確認などのメールアクションを処理する場合、ディープリンクから oobCode クエリパラメータのアクションコードを解析した後、applyActionCode を使用してそのコードを適用し、変更を有効にする（メール確認などが行われるようにする）必要があります。

モバイルアプリでメールアクションを処理する

モバイルアプリがインストールされている場合に、最初にモバイルアプリ内でアクションコードリンクを処理するかどうかを指定できます。Android アプリの場合は、installIfNotAvailable（ブール値）を使って、デバイスでサポートされているアプリがまだインストールされていなければインストールするよう指定することもできます。そのモバイルアプリをサポートしていないデバイスからリンクがクリックされた場合、リンクはウェブページから開かれます。これは、ActionCodeSettings.Builder オブジェクト内で setHandleCodeInApp(true) を呼び出すことで行われます。モバイルアプリの Android パッケージ名または iOS バンドル ID も指定する必要があります。

モバイルアプリが使用できない場合に使用される代替ウェブ URL は、メールアクションテンプレートのセクションで構成された URL です。デフォルトの URL がすべてのプロジェクトにプロビジョニングされます。メールアクションハンドラをカスタマイズする方法について詳しくは、メールハンドラのカスタマイズをご覧ください。

この場合、ユーザーに送信されるモバイルアプリリンクは、ペイロードがアクションコード URL の FDL リンクとなります。この FDL リンクは、コンソールで構成され、oobCode、mode、apiKey、continueUrl のクエリパラメータを含んでいます。後者は、ActionCodeSettings オブジェクトで指定された元の URL になります。アプリからの受信リンクは、他の依存関係なしでもインターセプトして処理できますが、FDL クライアントライブラリを使用してディープリンクを解析することをおすすめします。アクションコードは、メールハンドラのカスタマイズで説明されているウェブフローからの処理方法と同様に、モバイルアプリから直接適用できます。

メール アクションで状態を渡す

メール アクションで状態 / 続行 URL を渡す