概要

Firebase Extensions を使用すると、アプリの開発、メンテナンス、拡張にかかる時間を短縮できます。

アプリやプロジェクトのニーズを解決する Firebase Extension が見つかったら、その拡張機能をインストールして構成するだけです。拡張機能の構成が複数必要な場合、インストールするインスタンスごとに異なる設定を使用して拡張機能を複数回インストールできます。

拡張機能を使用すると、アプリやプロジェクトの機能を実装したり、タスクを自動化したりするコードの調査、作成、デバッグに時間がかかりません。

拡張機能のインストールや管理を行うには、オーナーまたは編集者、あるいは Firebase 管理者のいずれかのロールが割り当てられている必要があります。

拡張機能をインストールするには、プロジェクトが Blaze(従量課金制)プランを利用している必要があります。拡張機能のインストールは無料ですが、Firebase サービス、または Cloud Secret Manager などのクラウド サービスの使用に対しては、使用量がサービスの無料枠を超えた場合に請求されることがあります。

Firebase Local Emulator Suite のコンポーネントである拡張機能エミュレータを使用して、拡張機能をプロジェクトにインストールする前に評価することができます。

公式 Firebase Extensions

公式 Firebase Extensions は、Firebase と Firebase Extensions パートナー サービスによって開発、テストされています。これらの拡張機能は信頼性が高く、安全です。

公式 Firebase Extensions を見る

Extensions Hub で公式 Firebase Extensions をご覧ください。

早期アクセス パートナー拡張機能

早期アクセス パートナー拡張機能は、拡張機能のパブリッシャーの早期アクセス プログラムへの参加者によって開発されています。Google によってビルドまたはテストされたものではありません。Google は、早期アクセス パートナー拡張機能を「現状のまま」提供し、明示または黙示を問わず、いかなる保証も行いません。Google は、この拡張機能の使用によって直接または間接の損害が発生したとしても一切の責任を負いません。

自分の拡張機能の公開について詳しくは、拡張機能のパブリッシャーの早期アクセス プログラムに登録してください。

拡張機能のソースコードを表示する

公式 Firebase Extensions のソースコードへのリンクを見つけるには、Extensions Hub で拡張機能のカードの [詳細] をクリックします。

早期アクセス パートナー拡張機能のソースコードへのリンクを確認するには、拡張機能のコンソールのインストール リンクまたは CLI の ext:install コマンドを使用して、インストール フローを開始します。ソースコードへのリンクとともに、その拡張機能に関する情報が表示されます。ソースを確認したいだけの場合は、インストールをキャンセルできます。

拡張機能のソースコードの内容

拡張機能のソース ディレクトリには以下が含まれています。

  • extension.yaml ファイル - 拡張機能のメタデータが含まれ、作成されるリソース、動作に必要な Google API とアクセスロール、拡張機能のユーザー構成パラメータ(環境変数)を定義します

  • functions ディレクトリ - 拡張機能のソースコードのファイルが含まれます

  • README ファイル - 拡張機能のメタデータ(ただし、人が読める形式)と、PREINSTALL ファイルの内容が含まれます

  • PREINSTALL ファイル - 拡張機能の仕組み、必要なプリインストール タスク、構成要件、拡張機能の詳細を説明します

  • POSTINSTALL ファイル - 具体的な使用手順と、さらなる統合の要件を説明します

拡張機能のリソース

すべての Firebase プロジェクトには、いくつかの種類の「リソース」が含まれます。プロジェクト リソースには、デプロイされる Cloud Functions、データベース インスタンス、Cloud Storage バケット、Cloud Scheduler ジョブ、Cloud Secret Manager データなどがあります。

拡張機能をインストールすると、Firebase によって新しい拡張機能インスタンス固有のリソースがプロジェクト内に作成されます。これらのリソースは、拡張機能が動作するために必要です。

拡張機能のインスタンスをアンインストールすると、その拡張機能のインスタンス専用に作成されたすべてのリソース(関数のセットなど)が削除されます。ただし、以下は削除されません

  • 拡張機能によって作成されたアーティファクト(保存された画像など)。

  • データベース インスタンスや Cloud Storage バケットなど、プロジェクト内の他のリソース。このような他のリソースを拡張機能が操作していた場合でも、拡張機能固有ではないため、拡張機能をアンインストールしても削除されません。

Firebase コンソールまたは Firebase CLI の使用

公式 Firebase Extensions のインストールと管理は、Firebase コンソールまたは Firebase CLI で行います。

操作 Firebase コンソール Firebase CLI
詳細情報の表示(プリインストール)
インストール
構成の表示(インストール後)
構成の編集
バージョンの更新
アンインストール

次のステップ