1. 始める前に
この Codelab では、Firebase を Friendly Eats という Next.js ウェブアプリ(レストランのレビューを投稿するウェブサイト)と統合する方法を学びます。

完成したウェブアプリには、Firebase が Next.js アプリの構築にどのように役立つかを示す便利な機能が用意されています。主な機能は次のとおりです。
- 自動ビルドとデプロイ: この Codelab では、Firebase App Hosting を使用して、構成済みのブランチに push するたびに Next.js コードを自動的にビルドしてデプロイします。
- ログインとログアウト: 完成したウェブアプリでは、Google でログインとログアウトができます。ユーザーのログインと永続性は、Firebase Authentication を通じて完全に管理されます。
- 画像: 完成したウェブアプリでは、ログインしたユーザーがレストランの画像をアップロードできます。画像アセットは Cloud Storage for Firebase に保存されます。Firebase JavaScript SDK は、アップロードされた画像に公開 URL を提供します。この公開 URL は、Cloud Firestore の関連するレストラン ドキュメントに保存されます。
- レビュー: 完成したウェブアプリでは、ログインしたユーザーがレストランのレビューを投稿できます。レビューは、星評価とテキストベースのメッセージで構成されます。レビュー情報は Cloud Firestore に保存されます。
- フィルタ: 完成したウェブアプリでは、ログインしたユーザーがカテゴリ、場所、価格に基づいてレストランのリストをフィルタできます。使用する並べ替え方法をカスタマイズすることもできます。データは Cloud Firestore からアクセスされ、使用されるフィルタに基づいて Firestore クエリが適用されます。
前提条件
- GitHub アカウント
- Next.js と JavaScript の知識
学習内容
- Next.js の App ルーターとサーバーサイド レンダリングで Firebase を使用する方法。
- Cloud Storage for Firebase で画像を保持する方法。
- Cloud Firestore データベースでデータを読み書きする方法。
- Firebase JavaScript SDK で Google でログインを使用する方法。
必要なもの
- Git
- Node.js の最新の安定版
- 任意のブラウザ(Google Chrome など)
- コードエディタとターミナルを備えた開発環境
- Firebase プロジェクトの作成と管理に使用する Google アカウント
- Firebase プロジェクトを Blaze のお支払いプランにアップグレードする機能
2. 開発環境と GitHub リポジトリを設定する
この Codelab では、アプリのスターター コードベースを提供し、Firebase CLI を使用します。
GitHub リポジトリを作成する
この Codelab のソースは https://github.com/firebase/friendlyeats-web にあります。リポジトリには複数のプラットフォーム用のサンプル プロジェクトが含まれています。ただし、この Codelab では nextjs-start ディレクトリのみを使用します。次のディレクトリに注意してください。
* `nextjs-start`: contains the starter code upon which you build.
* `nextjs-end`: contains the solution code for the finished web app.
nextjs-start フォルダを独自のリポジトリにコピーします。
- ターミナルを使用して、パソコンに新しいフォルダを作成し、新しいディレクトリに移動します。
mkdir codelab-friendlyeats-web cd codelab-friendlyeats-web - giget npm パッケージを使用して、
nextjs-startフォルダのみを取得します。npx giget@latest "gh:firebase/friendlyeats-web/nextjs-start#master" . --install - git を使用してローカルで変更を追跡します。
git init git add . git commit -m "Codelab starting point" git branch -M main - 新しい GitHub リポジトリを作成します(https://github.com/new)。任意の名前を付けます。
- GitHub への認証方法(HTTPS または SSH)に応じて、GitHub が作成した新しい URL をコピーします。
https://github.com/<USER_NAME>/<REPOSITORY_NAME>.gitまたはgit@github.com:<USER_NAME>/<REPOSITORY_NAME>.git
- 次のコマンドを実行して、ローカルの変更を新しい GitHub リポジトリに push します。
<REPOSITORY_URL>プレースホルダは、実際のリポジトリ URL に置き換えます。git remote add origin <REPOSITORY_URL> git push -u origin main - GitHub リポジトリにスターター コードが表示されます。
Firebase CLI をインストールまたは更新する
次のコマンドを実行して、Firebase CLI がインストールされていること、およびバージョンが v14.1.0 以降であることを確認します。
firebase --version
これより古いバージョンが表示される場合、または Firebase CLI がインストールされていない場合は、次のインストール コマンドを実行します。
npm install -g firebase-tools@latest
権限エラーが原因で Firebase CLI をインストールできない場合は、npm のドキュメントを参照するか、別のインストール オプションを使用してください。
Firebase にログインする
- 次のコマンドを実行して Firebase CLI にログインします。
firebase login
- Firebase でデータを収集するかどうかに応じて、
YまたはNを入力します。 - ブラウザで Google アカウントを選択し、[許可] をクリックします。
3. Firebase プロジェクトを設定する
このセクションでは、Firebase プロジェクトを設定し、Firebase ウェブアプリを関連付けます。また、サンプル ウェブアプリで使用される Firebase サービスも設定します。
Firebase プロジェクトを作成する
- 前の手順で使用したのと同じ Google アカウントを使用して Firebase コンソールにログインします。
- ボタンをクリックして新しいプロジェクトを作成し、プロジェクト名(例:
FriendlyEats Codelab)を入力します。
- [続行] をクリックします。
- Firebase の利用規約が表示されたら、内容を読み、同意して [続行] をクリックします。
- (省略可)Firebase コンソールで AI アシスタンス(「Gemini in Firebase」)を有効にします。
- この Codelab では Google アナリティクスは不要なため、Google アナリティクスのオプションをオフにします。
- [プロジェクトを作成] をクリックし、プロジェクトがプロビジョニングされるまで待ってから、[続行] をクリックします。
Firebase の料金プランをアップグレードする
Firebase App Hosting と Cloud Storage for Firebase を使用するには、Firebase プロジェクトが従量課金制(Blaze)の料金プランに登録されている必要があります。つまり、Cloud 請求先アカウントにリンクされている必要があります。
- Cloud 請求先アカウントには、クレジット カードなどのお支払い方法を設定する必要があります。
- Firebase と Google Cloud を初めて使用する場合は、$300 のクレジットと無料トライアル用 Cloud 請求先アカウントを利用できるかどうかご確認ください。
- イベントの一環としてこの Codelab を行う場合は、利用可能な Cloud クレジットがあるかどうかを主催者に確認してください。
プロジェクトを Blaze プランにアップグレードする手順は次のとおりです。
- Firebase コンソールで、プランをアップグレードします。
- Blaze プランを選択します。画面上の手順に沿って、Cloud 請求先アカウントをプロジェクトにリンクします。
このアップグレードの一環として Cloud 請求先アカウントを作成する必要があった場合は、Firebase コンソールのアップグレード フローに戻ってアップグレードを完了する必要があります。
Firebase プロジェクトにウェブアプリを追加する
- Firebase プロジェクトの [プロジェクトの概要] に移動し、[アプリを追加]、[ウェブ] の順にクリックします。
- [アプリのニックネーム] テキスト ボックスに、覚えやすいアプリのニックネーム(
My Next.js appなど)を入力します。 - [このアプリの Firebase Hosting も設定します] チェックボックスはオフのままにします。
- [アプリの登録] > [コンソールに進む] をクリックします。
Firebase コンソールで Firebase サービスを設定する
Authentication を設定する
- Firebase コンソールの左側のパネルで [ビルド] を展開し、[Authentication] を選択します。
- [開始] をクリックします。
- [ログイン プロバイダ] 列で、[Google] > [有効にする] をクリックします。
- [プロジェクトの公開名] テキスト ボックスに、覚えやすい名前(
My Next.js appなど)を入力します。 - [プロジェクトのサポートメール] プルダウンから、メールアドレスを選択します。
- [保存] をクリックします。
Cloud Firestore を設定する
- Firebase コンソールの左側のパネルで [ビルド] を展開し、[Firestore データベース] を選択します。
- [データベースを作成] をクリックします。
- [Standard エディション] を選択して [次へ] をクリックします。
- [データベース ID] は変更せず、
(default)のままにします。 - データベースのロケーションを選択し、[次へ] をクリックします。
実際のアプリでは、ユーザーに近いロケーションを選択します。 - [テストモードで開始する] をクリックします。セキュリティ ルールに関する免責条項を確認します。
この Codelab の後半で、データを保護するためのセキュリティ ルールを追加します。データベースのセキュリティ ルールを追加せずに、アプリを配布または公開しないでください。 - [作成] をクリックします。
Cloud Storage for Firebase を設定する
- Firebase コンソールの左側のパネルで [ビルド] を展開し、[Storage] を選択します。
- [開始] をクリックします。
- デフォルトの Storage バケットのロケーションを選択します。
US-WEST1、US-CENTRAL1、US-EAST1のバケットは、Google Cloud Storage の「Always Free」枠を利用できます。他のすべてのロケーションのバケットは、Google Cloud Storage の料金と使用量に従います。 - [テストモードで開始する] をクリックします。セキュリティ ルールに関する免責条項を確認します。
この Codelab の後半で、データを保護するためのセキュリティ ルールを追加します。Storage バケットのセキュリティ ルールを追加せずに、アプリを配布または公開しないでください。 - [作成] をクリックします。
セキュリティ ルールをデプロイする
このコードには、Firestore と Cloud Storage for Firebase のセキュリティ ルールがすでに設定されています。セキュリティ ルールをデプロイすると、データベースとバケット内のデータが不正使用から保護されます。
- ターミナルで、先ほど作成した Firebase プロジェクトを使用するように CLI を構成します。
エイリアスの入力を求められたら、「firebase use --add
friendlyeats-codelab」と入力します。 - これらのセキュリティ ルール(および後で必要になるインデックス)をデプロイするには、ターミナルで次のコマンドを実行します。
firebase deploy --only firestore,storage
- 「
"Cloud Storage for Firebase needs an IAM Role to use cross-service rules. Grant the new role?"」というメッセージが表示されたら、Enterを押して [はい] を選択します。
4. スターター コードベースを確認する
このセクションでは、この Codelab で機能を追加するアプリのスターター コードベースのいくつかの領域を確認します。
フォルダとファイルの構造
次の表に、アプリのフォルダとファイル構造の概要を示します。
フォルダとファイル | 説明 |
| フィルタ、ヘッダー、レストランの詳細、クチコミ用の React コンポーネント |
| React や Next.js に必ずしもバインドされていないユーティリティ関数 |
| Firebase 固有のコードと Firebase 構成 |
| ウェブアプリの静的アセット(アイコンなど) |
| Next.js App Router を使用したルーティング |
| npm を使用したプロジェクトの依存関係 |
| Next.js 固有の構成(サーバー アクションが有効になっている) |
| JavaScript 言語サービスの構成 |
サーバー コンポーネントとクライアント コンポーネント
このアプリは、App Router を使用する Next.js ウェブアプリです。サーバー レンダリングはアプリ全体で使用されます。たとえば、src/app/page.js ファイルはメインページを処理するサーバー コンポーネントです。src/components/RestaurantListings.jsx ファイルは、ファイルの先頭にある "use client" ディレクティブで示されるクライアント コンポーネントです。
インポート ステートメント
次のような import ステートメントがあることに気づくかもしれません。
import RatingPicker from "@/src/components/RatingPicker.jsx";
このアプリでは、@ 記号を使用して、扱いにくい相対インポートパスを回避しています。これは、パス エイリアスによって可能になっています。
Firebase 固有の API
すべての Firebase API コードは src/lib/firebase ディレクトリにラップされています。個々の React コンポーネントは、Firebase Functions を直接インポートするのではなく、ラップされた関数を src/lib/firebase ディレクトリからインポートします。
モックデータ
モックのレストランとレビューのデータは src/lib/randomData.js ファイルに含まれています。このファイルからのデータは、src/lib/fakeRestaurants.js ファイルのコードで組み立てられます。
5. App Hosting バックエンドを作成する
このセクションでは、Git リポジトリのブランチを監視するように App Hosting バックエンドを設定します。
このセクションを完了すると、GitHub のリポジトリに接続された App Hosting バックエンドが作成され、main ブランチに新しい commit を push するたびに、アプリの新しいバージョンが自動的に再ビルドされてロールアウトされるようになります。
バックエンドの作成
- Firebase コンソールの [App Hosting] ページに移動します。
- [開始] をクリックして、バックエンドの作成フローを開始します。
- 地域を選択します。実際のアプリでは、ユーザーに最も近いリージョンを選択します。
- [GitHub リポジトリをインポートする] ステップのプロンプトに沿って、GitHub 認証を設定します。
- [リポジトリ] で、[GitHub の新しいリポジトリへのアクセスを許可する] を選択し、プロンプトに沿って、先ほど作成した GitHub リポジトリへのアクセスを有効にします。
- [リストを更新] をクリックしてリストを更新し、リポジトリを選択して [次へ] をクリックします。
- デプロイ設定を行います。
- ライブブランチを
mainに設定します。 - ルート ディレクトリを
/のままにします。 - 自動ロールアウトを有効にする。
- ライブブランチを
- バックエンドに「
friendlyeats-codelab」という名前を付け、[次へ] をクリックします。 - [Firebase ウェブアプリを関連付ける] で、[既存の Firebase ウェブアプリを選択する] を選択し、追加したアプリをリストから選択します。
- [完了してデプロイ] をクリックします。新しいページにリダイレクトされ、新しい App Hosting バックエンドのステータスを確認できます。
- [表示] をクリックすると、ロールアウト ステータス、ログ、使用状況の詳細など、App Hosting デプロイの詳細が表示されます。
- ロールアウトが完了したら、[ドメイン] の下にあるサイトの URL をクリックして開きます。DNS の伝播により、動作が開始するまでに数分かかることがあります。
- タイムアウトページを読み込むと、「Application error: サーバーサイドで例外が発生しました (詳細はサーバーログを参照してください)。」というエラー メッセージが表示されます。
- Firebase コンソールで、App Hosting バックエンドの [ログ] タブを確認します。「Error: not implemented」というログが表示されます。これは、次のステップで認証を追加するときに修正します。
最初のウェブアプリをデプロイしました。GitHub リポジトリの main ブランチに新しい commit を push するたびに、Firebase コンソールで新しいビルドとロールアウトが開始され、ロールアウトが完了するとサイトが自動的に更新されます。
6. ウェブアプリに認証を追加する
このセクションでは、ウェブアプリに認証を追加して、ログインできるようにします。
承認済みドメインを追加します
Firebase Authentication は、許可されたドメインからのログイン リクエストのみを受け入れます。ここでは、App Hosting バックエンドのドメインをプロジェクトの承認済みドメインのリストに追加します。
- [App Hosting] ページを開き、デプロイされたサイトの下にある [表示] をクリックして、[概要] ページにアクセスします。App Hosting バックエンドのドメイン名をコピーします。
- [Auth Settings] タブに移動し、承認済みドメインを追加するプロジェクトを選択します。[承認済みドメイン] セクションを見つけてクリックします。
- [ドメインを追加] ボタンをクリックします。
- App Hosting バックエンドのドメインを入力します。
- [追加] をクリックします。
ログイン関数とログアウト関数を実装する
src/lib/firebase/auth.js ファイルで、onAuthStateChanged、onIdTokenChanged、signInWithGoogle、signOut 関数を次のコードに置き換えます。
export function onAuthStateChanged(cb) {
return _onAuthStateChanged(auth, cb);
}
export function onIdTokenChanged(cb) {
return _onIdTokenChanged(auth, cb);
}
export async function signInWithGoogle() {
const provider = new GoogleAuthProvider();
try {
await signInWithPopup(auth, provider);
} catch (error) {
console.error("Error signing in with Google", error);
}
}
export async function signOut() {
try {
return auth.signOut();
} catch (error) {
console.error("Error signing out with Google", error);
}
}
このコードでは、次の Firebase API を使用します。
Firebase API | 説明 |
ユーザーのログイン状態の変化を監視するオブザーバーを追加します。 | |
ユーザーの ID トークンの変更を監視するオブザーバーを追加します。 | |
Google 認証プロバイダのインスタンスを作成します。 | |
ダイアログ ベースの認証フローを開始します。 | |
ユーザーをログアウトします。 |
src/components/Header.jsx ファイルでは、コードがすでに signInWithGoogle 関数と signOut 関数を呼び出しています。
認証状態をサーバーに送信する
認証状態をサーバーに渡すには、Cookie を使用します。クライアントで認証状態が変更されるたびに、__session Cookie が更新されます。
src/components/Header.jsx で、useUserSession 関数を次のコードに置き換えます。
function useUserSession(initialUser) {
useEffect(() => {
return onIdTokenChanged(async (user) => {
if (user) {
const idToken = await user.getIdToken();
await setCookie("__session", idToken);
} else {
await deleteCookie("__session");
}
if (initialUser?.uid === user?.uid) {
return;
}
window.location.reload();
});
}, [initialUser]);
return initialUser;
}
サーバーで認証状態を読み取る
FirebaseServerApp を使用して、サーバー上のクライアントの認証状態をミラーリングします。
src/lib/firebase/serverApp.js を開き、getAuthenticatedAppForUser 関数を置き換えます。
export async function getAuthenticatedAppForUser() {
const authIdToken = (await cookies()).get("__session")?.value;
// Firebase Server App is a new feature in the JS SDK that allows you to
// instantiate the SDK with credentials retrieved from the client & has
// other affordances for use in server environments.
const firebaseServerApp = initializeServerApp(
// https://github.com/firebase/firebase-js-sdk/issues/8863#issuecomment-2751401913
initializeApp(),
{
authIdToken,
}
);
const auth = getAuth(firebaseServerApp);
await auth.authStateReady();
return { firebaseServerApp, currentUser: auth.currentUser };
}
変更を確認する
src/app/layout.js ファイルのルート レイアウトは、ヘッダーをレンダリングし、ユーザー(存在する場合)をプロパティとして渡します。
<Header initialUser={currentUser?.toJSON()} />
つまり、<Header> コンポーネントは、サーバーの実行時にユーザーデータ(利用可能な場合)をレンダリングします。最初のページ読み込み後のページ ライフサイクル中に認証の更新があった場合は、onAuthStateChanged ハンドラが処理します。
次に、新しいビルドをロールアウトして、作成したものを検証します。
- 「Add authentication」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Add authentication" git push - App Hosting ページを開き、新しいロールアウトが完了したら、サイトの URL をクリックして開きます。
- 認証をテストする:
- Google アカウントでログインし、ログイン後にヘッダーに表示名が表示されることを確認します。
- ログアウトしてもう一度ログインしてください。 この手順を別のユーザーで繰り返すことができます。
- 省略可: ウェブアプリを右クリックし、[ページのソースを表示] を選択して、表示名を検索します。サーバーから返された未加工の HTML ソースに表示される。
7. レストランの情報を表示する
このウェブアプリには、レストランとレビューのモックデータが含まれています。
レストランを 1 つ以上追加する
ローカルの Cloud Firestore データベースにレストランのモックデータを挿入する手順は次のとおりです。
- まだログインしていない場合は、ウェブアプリにログインします。次に、
> [Add sample restaurants] を選択します。データ取得コードをまだ設定していないため、Friendly Eats ウェブアプリにレストランが表示されないことに注意してください。これは次のステップで修正します。 - Firebase コンソールの [Firestore データベース] ページで、[restaurants] を選択します。レストラン コレクションに、それぞれがレストランを表す最上位のドキュメントが表示されます。
- いくつかのドキュメントをクリックして、レストラン ドキュメントのプロパティを確認します。
レストランのリストを表示する
これで、Cloud Firestore データベースに、Next.js ウェブアプリで表示できるレストランが追加されました。
データ取得コードを定義する手順は次のとおりです。
src/app/page.jsファイルで、<Home />サーバー コンポーネントを見つけ、getRestaurants関数の呼び出しを確認します。この関数は、サーバーの実行時にレストランのリストを取得します。次の手順でgetRestaurants関数を実装します。src/lib/firebase/firestore.jsファイルで、applyQueryFilters関数とgetRestaurants関数を次のコードに置き換えます。
function applyQueryFilters(q, { category, city, price, sort }) {
if (category) {
q = query(q, where("category", "==", category));
}
if (city) {
q = query(q, where("city", "==", city));
}
if (price) {
q = query(q, where("price", "==", price.length));
}
if (sort === "Rating" || !sort) {
q = query(q, orderBy("avgRating", "desc"));
} else if (sort === "Review") {
q = query(q, orderBy("numRatings", "desc"));
}
return q;
}
export async function getRestaurants(db = db, filters = {}) {
let q = query(collection(db, "restaurants"));
q = applyQueryFilters(q, filters);
const results = await getDocs(q);
return results.docs.map((doc) => {
return {
id: doc.id,
...doc.data(),
// Only plain objects can be passed to Client Components from Server Components
timestamp: doc.data().timestamp.toDate(),
};
});
}
- 「Read the list of restaurants from Firestore」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Read the list of restaurants from Firestore" git push - Firebase コンソールの [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
- ウェブアプリでページを更新します。レストランの画像がページにタイルとして表示されます。
サーバーの実行時にレストランのリスティングが読み込まれることを確認する
Next.js フレームワークを使用している場合、データがサーバーのランタイムで読み込まれるのか、クライアントサイドのランタイムで読み込まれるのかが明確でないことがあります。
サーバーの実行時にレストランのリスティングが読み込まれることを確認する手順は次のとおりです。
- ウェブアプリで DevTools を開き、JavaScript を無効にします。

- ウェブアプリを更新します。レストランのリストは引き続き読み込まれます。レストランの情報がサーバー レスポンスで返されます。JavaScript が有効になっている場合、レストラン情報はクライアントサイドの JavaScript コードを介してハイドレートされます。
- DevTools で JavaScript を再度有効にします。
Cloud Firestore スナップショット リスナーを使用してレストランの更新をリッスンする
前のセクションでは、src/app/page.js ファイルから読み込まれたレストランの初期セットを確認しました。src/app/page.js ファイルはサーバー コンポーネントであり、Firebase のデータ取得コードを含めてサーバー上でレンダリングされます。
src/components/RestaurantListings.jsx ファイルはクライアント コンポーネントであり、サーバーでレンダリングされたマークアップをハイドレートするように構成できます。
サーバーでレンダリングされたマークアップをハイドレートするように src/components/RestaurantListings.jsx ファイルを構成する手順は次のとおりです。
src/components/RestaurantListings.jsxファイルで、すでに記述されている次のコードを確認します。
useEffect(() => {
return getRestaurantsSnapshot((data) => {
setRestaurants(data);
}, filters);
}, [filters]);
このコードは getRestaurantsSnapshot() 関数を呼び出します。これは、前のステップで実装した getRestaurants() 関数に似ています。ただし、このスナップショット関数はコールバック メカニズムを提供するため、レストランのコレクションに変更が加えられるたびにコールバックが呼び出されます。
src/lib/firebase/firestore.jsファイルで、getRestaurantsSnapshot()関数を次のコードに置き換えます。
export function getRestaurantsSnapshot(cb, filters = {}) {
if (typeof cb !== "function") {
console.log("Error: The callback parameter is not a function");
return;
}
let q = query(collection(db, "restaurants"));
q = applyQueryFilters(q, filters);
return onSnapshot(q, (querySnapshot) => {
const results = querySnapshot.docs.map((doc) => {
return {
id: doc.id,
...doc.data(),
// Only plain objects can be passed to Client Components from Server Components
timestamp: doc.data().timestamp.toDate(),
};
});
cb(results);
});
}
src/lib/firebase/firestore.jsファイルで、getRestaurantSnapshotById()関数を次のコードに置き換えます。
export function getRestaurantSnapshotById(restaurantId, cb) {
if (!restaurantId) {
console.log("Error: Invalid ID received: ", restaurantId);
return;
}
if (typeof cb !== "function") {
console.log("Error: The callback parameter is not a function");
return;
}
const docRef = doc(db, "restaurants", restaurantId);
return onSnapshot(docRef, (docSnap) => {
cb({
...docSnap.data(),
timestamp: docSnap.data().timestamp.toDate(),
});
});
}
[Firestore データベース] ページで行った変更が、ウェブアプリにリアルタイムで反映されるようになりました。
- 「Listen for realtime restaurant updates」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Listen for realtime restaurant updates" git push - Firebase コンソールの [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
- ウェブアプリで、
> [Add sample restaurants] を選択します。スナップショット関数が正しく実装されていれば、ページを更新しなくてもレストランがリアルタイムで表示されます。
8. ウェブアプリからユーザーが送信したレビューを保存する
src/lib/firebase/firestore.jsファイルで、updateWithRating()関数を次のコードに置き換えます。
const updateWithRating = async (
transaction,
docRef,
newRatingDocument,
review
) => {
const restaurant = await transaction.get(docRef);
const data = restaurant.data();
const newNumRatings = data?.numRatings ? data.numRatings + 1 : 1;
const newSumRating = (data?.sumRating || 0) + Number(review.rating);
const newAverage = newSumRating / newNumRatings;
transaction.update(docRef, {
numRatings: newNumRatings,
sumRating: newSumRating,
avgRating: newAverage,
});
transaction.set(newRatingDocument, {
...review,
timestamp: Timestamp.fromDate(new Date()),
});
};
このコードは、新しいレビューを表す新しい Firestore ドキュメントを挿入します。また、このコードは、レストランを表す既存の Firestore ドキュメントを、更新された評価数と計算された平均評価で更新します。
- 関数全体を次の
addReviewToRestaurant()に置き換えます。
export async function addReviewToRestaurant(db, restaurantId, review) {
if (!restaurantId) {
throw new Error("No restaurant ID has been provided.");
}
if (!review) {
throw new Error("A valid review has not been provided.");
}
try {
const docRef = doc(collection(db, "restaurants"), restaurantId);
const newRatingDocument = doc(
collection(db, `restaurants/${restaurantId}/ratings`),
);
// corrected line
await runTransaction(db, (transaction) =>
updateWithRating(transaction, docRef, newRatingDocument, review),
);
} catch (error) {
console.error(
"There was an error adding the rating to the restaurant",
error,
);
throw error;
}
}
Next.js サーバー アクションを実装する
Next.js サーバー アクションは、フォームデータにアクセスするための便利な API を提供します。たとえば、data.get("text") を使用して、フォーム送信ペイロードからテキスト値を取得できます。
Next.js サーバー アクションを使用してレビュー フォームの送信を処理する手順は次のとおりです。
src/components/ReviewDialog.jsxファイルで、<form>要素のaction属性を見つけます。
<form
action={handleReviewFormSubmission}
onSubmit={() => {
handleClose();
}}
>
action 属性値は、次のステップで実装する関数を参照します。
src/app/actions.jsファイルで、handleReviewFormSubmission()関数を次のコードに置き換えます。
export async function handleReviewFormSubmission(data) {
const { firebaseServerApp } = await getAuthenticatedAppForUser();
const db = getFirestore(firebaseServerApp);
await addReviewToRestaurant(db, data.get("restaurantId"), {
text: data.get("text"),
rating: data.get("rating"),
// This came from a hidden form field.
userId: data.get("userId"),
});
}
レストランのクチコミを追加する
レビュー送信のサポートを実装したので、レビューが Cloud Firestore に正しく挿入されていることを確認できるようになりました。
レビューを追加して、Cloud Firestore に挿入されていることを確認する手順は次のとおりです。
- 「Allow users to submit restaurant reviews」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Allow users to submit restaurant reviews" git push - Firebase コンソールの [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
- ウェブアプリを更新し、ホームページからレストランを選択します。
- レストランのページで
をクリックします。 - 評価を選択してください。
- クチコミを書く。
- [送信] をクリックします。クチコミはクチコミのリストの一番上に表示されます。
- Cloud Firestore の [ドキュメントを追加] パネルで、レビューしたレストランのドキュメントを検索して選択します。
- [コレクションを開始] パネルで、[評価] を選択します。
- [ドキュメントを追加] パネルで、レビュー用のドキュメントを見つけて、想定どおりに挿入されていることを確認します。
9. ウェブアプリからユーザーがアップロードしたファイルを保存する
このセクションでは、ログイン時にレストランに関連付けられた画像を置き換えることができる機能を追加します。画像を Firebase Storage にアップロードし、レストランを表す Cloud Firestore ドキュメント内の画像 URL を更新します。
ウェブアプリからユーザーがアップロードしたファイルを保存する手順は次のとおりです。
src/components/Restaurant.jsxファイルで、ユーザーがファイルをアップロードしたときに実行されるコードを確認します。
async function handleRestaurantImage(target) {
const image = target.files ? target.files[0] : null;
if (!image) {
return;
}
const imageURL = await updateRestaurantImage(id, image);
setRestaurantDetails({ ...restaurantDetails, photo: imageURL });
}
この関数を変更する必要はありませんが、次の手順で updateRestaurantImage() 関数の動作を実装します。
src/lib/firebase/storage.jsファイルで、updateRestaurantImage()関数とuploadImage()関数を次のコードに置き換えます。
export async function updateRestaurantImage(restaurantId, image) {
try {
if (!restaurantId) {
throw new Error("No restaurant ID has been provided.");
}
if (!image || !image.name) {
throw new Error("A valid image has not been provided.");
}
const publicImageUrl = await uploadImage(restaurantId, image);
await updateRestaurantImageReference(restaurantId, publicImageUrl);
return publicImageUrl;
} catch (error) {
console.error("Error processing request:", error);
}
}
async function uploadImage(restaurantId, image) {
const filePath = `images/${restaurantId}/${image.name}`;
const newImageRef = ref(storage, filePath);
await uploadBytesResumable(newImageRef, image);
return await getDownloadURL(newImageRef);
}
updateRestaurantImageReference() 関数はすでに実装されています。この関数は、更新された画像 URL を使用して、Cloud Firestore の既存のレストラン ドキュメントを更新します。
画像アップロード機能を確認する
画像が想定どおりにアップロードされることを確認する手順は次のとおりです。
- 「Allow users to change each restaurants' photo」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Allow users to change each restaurants' photo" git push - Firebase コンソールの [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
- ウェブアプリで、ログインしていることを確認し、レストランを選択します。
をクリックして、ファイル システムから画像をアップロードします。画像はローカル環境から Cloud Storage にアップロードされます。画像はアップロードするとすぐに表示されます。- Firebase の Cloud Storage に移動します。
- レストランを表すフォルダに移動します。アップロードした画像がフォルダに存在します。

10. 生成 AI でレストランのクチコミを要約する
このセクションでは、クチコミの要約機能を追加します。これにより、ユーザーはすべてのクチコミを読まなくても、レストランに対する他のユーザーの評価をすぐに把握できるようになります。
Gemini API キーを Cloud Secret Manager に保存する
- Gemini API を使用するには、API キーが必要です。Google AI Studio にアクセスし、[Create API キー] をクリックします。
- 鍵に任意の名前を付けます。[インポートしたプロジェクトを選択] にプロジェクトが表示されていない場合は、[プロジェクトをインポート] をクリックし、リストでプロジェクトをオンにして、[インポート] をクリックします。最後に、[インポートしたプロジェクトを選択] でプロジェクトを選択し、[鍵を作成] をクリックします。
- App Hosting は Cloud Secret Manager と統合されているため、API キーなどの機密性の高い値を安全に保存できます。
- ターミナルで、次のコマンドを実行して新しいシークレットを作成します。
firebase apphosting:secrets:set GEMINI_API_KEY- シークレット値の入力を求められたら、Google AI Studio から Gemini API キーをコピーして貼り付けます。
- 新しいシークレットが本番環境用かローカルテスト用かを尋ねられたら、[Production] を選択します。
- バックエンドのサービス アカウントがシークレットにアクセスできるようにアクセス権を付与するかどうかを尋ねられたら、[はい] を選択します。
- 新しいシークレットを
apphosting.yamlに追加するかどうかを尋ねられたら、「Y」と入力して承認します。
Gemini API キーが Cloud Secret Manager に安全に保存され、App Hosting バックエンドからアクセスできるようになりました。
クチコミの要約コンポーネントを実装する
src/components/Reviews/ReviewSummary.jsxで、GeminiSummary関数を次のコードに置き換えます。export async function GeminiSummary({ restaurantId }) { const { firebaseServerApp } = await getAuthenticatedAppForUser(); const reviews = await getReviewsByRestaurantId( getFirestore(firebaseServerApp), restaurantId ); const reviewSeparator = "@"; const prompt = ` Based on the following restaurant reviews, where each review is separated by a '${reviewSeparator}' character, create a one-sentence summary of what people think of the restaurant. Here are the reviews: ${reviews.map((review) => review.text).join(reviewSeparator)} `; try { if (!process.env.GEMINI_API_KEY) { // Make sure GEMINI_API_KEY environment variable is set: // https://genkit.dev/docs/get-started/ throw new Error( 'GEMINI_API_KEY not set. Set it with "firebase apphosting:secrets:set GEMINI_API_KEY"' ); } // Configure a Genkit instance. const ai = genkit({ plugins: [googleAI()], model: gemini20Flash, // set default model }); const { text } = await ai.generate(prompt); return ( <div className="restaurant__review_summary"> <p>{text}</p> <p>✨ Summarized with Gemini</p> </div> ); } catch (e) { console.error(e); return <p>Error summarizing reviews.</p>; } }- 「AI を使用してレビューを要約する」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
git add . git commit -m "Use AI to summarize reviews" git push - Firebase コンソールの [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
- レストランのページを開きます。ページの上部に、ページ上のすべてのレビューの 1 文の要約が表示されます。
- 新しいレビューを追加して、ページを更新します。概要が変更されます。
11. App Hosting サイトの公開を停止する
この Codelab を完了した後、アプリを引き続き使用しない場合は、アプリの公開を停止して、Firestore、Storage、Gemini のリソースに誰もアクセスできないようにすることができます。再公開はいつでもできます。
App Hosting サイトの公開を停止するには:
- Firebase コンソールで App Hosting を開きます。
- アプリのバックエンドを見つけて、[表示] をクリックします。
- [バックエンド情報] セクションで、[ドメイン] の横にある [管理] をクリックします。[ドメイン] ページが読み込まれます。
- ドメインの横にある [その他] アイコン(縦に並んだ 3 つの点)をクリックし、[ドメインを無効にする] を選択して、[無効にする] をクリックして確定します。
12. まとめ
これで完了です。Firebase を使用して Next.js アプリに機能を追加する方法を学びました。具体的には、次の機能を使用しました。
- Firebase App Hosting。構成済みのブランチに push するたびに Next.js コードを自動的にビルドしてデプロイします。
- Firebase Authentication。ログイン機能とログアウト機能を有効にします。
- Cloud Firestore: レストランのデータとレストランのレビューデータ。
- レストランの画像用の Cloud Storage for Firebase。