Firebase Studio の新機能から AI を統合するさまざまな方法まで、I/O で発表された内容をすべてご紹介します。ブログを読む。

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

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

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

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

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

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

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

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

メソッド	説明
`setUrl(String url)`	コンテキストによって異なる意味を持つリンク（状態 / 続行 URL）を設定します。リンクがウェブアクションウィジェットで処理される場合、これは `continueUrl` クエリパラメータのディープリンクを表します。リンクがアプリ内で直接処理される場合、これは Hosting リンクのディープリンク内の `continueUrl` クエリパラメータを表します。
`setIOSBundleId(String iOSBundleId)`	iOS バンドル ID を設定して、Firebase Authentication が Apple デバイスで開くウェブ専用リンクとモバイルリンクのどちらを作成するかを判断できるようにします。
`setAndroidPackageName(String androidPackageName, boolean installIfNotAvailable, String minimumVersion)`	Android パッケージ名を設定して、Firebase Authentication が Android デバイスで開くウェブ専用リンクとモバイルリンクのどちらを作成するかを判断できるようにします。
`setHandleCodeInApp(boolean status)`	メールアクションリンクがモバイルアプリとウェブリンクのどちらで最初に開かれるかを示します。デフォルトは false です。true に設定すると、アクションコードリンクはユニバーサルリンクまたは Android アプリリンクとして送信され、アプリがインストールされている場合はそのアプリで開かれます。false の場合、コードは最初にウェブウィジェットに送信され、続いてアプリがインストールされている場合はそのアプリにリダイレクトされます。
`setLinkDomain(String customDomain)`	プロジェクトにカスタム Hosting リンクドメインが定義されている場合に、指定したモバイルアプリでリンクを開く際に使用するドメインを指定します。指定しない場合、デフォルトのドメインが自動的に選択されます（`PROJECT_ID.firebaseapp.com` など）。
`setDynamicLinkDomain(String dynamicLinkDomain)`	非推奨。このパラメータは指定しないでください。

次の例は、モバイルアプリで最初に開かれるメール確認リンクを送信する方法を示しています。ディープリンクには、続行 URL ペイロード http://www.example.com/verify?uid=1234 が含まれています。

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 Hosting リンクを構成する

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

Android アプリを構成します。
1. これらのリンクを Android アプリで処理する場合は、Firebase コンソールのプロジェクト設定でアプリのパッケージ名を指定する必要があります。それに加えて、アプリ証明書の SHA-1 および SHA-256 を指定する必要があります。
2. AndroidManifest.xml ファイルで、ディープリンクのインテントフィルタを構成する必要があります。
3. 詳しくは、Android Hosting リンクの受信の手順をご覧ください。
iOS アプリを構成します。
1. これらのリンクを iOS アプリで処理する場合は、アプリ機能の関連ドメインとして Hosting リンクドメインを構成する必要があります。
2. 詳しくは、iOS Hosting リンクの受信の手順をご覧ください。

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

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

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

この場合、continueUrl クエリパラメータ内のリンクは、ActionCodeSettings オブジェクトで指定された URL がペイロードに含まれる Hosting リンクになります。

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

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

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

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

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

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

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