Firestore クライアント ライブラリ

このページでは、Firestore API で利用できる SDK とクライアント ライブラリについて説明します。HTTP 呼び出しまたは RPC 呼び出しを使用して Firestore API を直接呼び出すこともできますが、Firestore クライアント ライブラリにはユーザー向けのベスト プラクティスが実装されているので、データベースへのアクセスがさらに簡単になります。

Firestore は、モバイル SDK またはウェブ SDK とサーバー クライアント ライブラリをサポートしています。

モバイル SDK とウェブ SDK

Firestore は、Android、iOS、ウェブ用の SDK をサポートしています。Firestore セキュリティ ルールと Firebase Auth を組み合わせると、モバイル SDK とウェブ SDK でサーバーレス アプリ アーキテクチャがサポートされ、これによりクライアントは Firestore データベースに直接接続できます。サーバーレス アーキテクチャでは、クライアントと Firestore データベースの間に中間サーバーを維持する必要はありません。

モバイル SDK とウェブ SDK は、リアルタイムの更新とオフライン データの永続性もサポートしています。

Android、Apple プラットフォーム、ウェブ SDK の使用にあたっては、ウェブまたはモバイル クライアント ライブラリを使用して Firestore データベースを作成するをご覧ください。

リファレンスとリソース

各 SDK の詳細については、次のリソースをご覧ください。

ウェブ

Firebase には、標準のクライアント SDK のほかに、REST 専用の軽量な SDK である Firestore Lite も用意されています。

iOS+
Android
Flutter

サーバー クライアント ライブラリ

Firestore は、C#、Go、Java、Node.js、PHP、Python、Ruby 用のサーバー クライアント ライブラリをサポートしています。特権的サーバー環境を設定するには、これらのクライアント ライブラリを使用します。

サーバー クライアント ライブラリは、データベースへの完全アクセス権を備えた特権的な Firestore 環境を作成します。この環境では、Firestore のセキュリティ ルールによってリクエストが評価されることはありません。特権的 Firestore サーバーは、Identity and Access Management（IAM）を使用して保護されます。サーバー クライアント ライブラリのセキュリティをご覧ください。

サーバー クライアント ライブラリはデータベースの管理タスク用に使用します。また、ユーザーと Firestore データベースの間に中間サーバーを配置したアーキテクチャが望ましい場合にも使用します。

Firestore サーバー クライアント ライブラリは、Firebase Admin SDK、および Google Cloud クライアント ライブラリとして提供されています。両方のライブラリ セットには Firestore 向けの同じ機能が用意されています。Firebase Admin SDK は、Firestore と他のいくつかの Firebase プロダクト（Firebase Auth や Firebase Cloud Messaging など）へのアクセスを単一のライブラリにまとめたものです。

Firebase Admin SDK

Firebase Admin SDK には、Firestore 用の Google Cloud クライアント ライブラリと、その他のいくつかの Firebase 機能用のクライアント ライブラリおよび SDK がバンドルされています。いずれかの Admin SDK を使用して、単一の SDK から Firestore や他のいくつかのサービスへのアクセスを初期化できます。Firebase Admin SDK は、Java、Python、Node.js、Go を使用した Firestore へのアクセスをサポートしています。

Firebase Admin SDK の使用を開始するには、サーバーに Firebase Admin SDK を追加するをご覧ください。

リファレンスとリソース

Firebase Admin SDK の詳細については、次のリソースをご覧ください。

Java
Python
Node.js
Go

Google Cloud クライアント ライブラリ

Google Cloud クライアント ライブラリは、Java、Python、Node.js、Go、PHP、C#、Ruby を使用した Firestore へのアクセスをサポートしています。Google Cloud クライアント ライブラリの使用を開始するには、サーバー クライアント ライブラリの使用に関するクイックスタートをご覧ください。

リファレンスとリソース

Firestore 向けの Google Cloud クライアント ライブラリの詳細については、次のリソースをご覧ください。

Java
Python
Node.js
Go
PHP
C#
Ruby

サードパーティ ライブラリの統合

Firestore には、モバイル SDK またはウェブ SDK とサーバー クライアント ライブラリに加えて、オープンソース ライブラリとの統合がいくつか用意されています。詳細については、ライブラリとフレームワークのインテグレーションをご覧ください。

次のステップ