コンソールへ移動

SDK とクライアント ライブラリ

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

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

モバイル SDK とウェブ SDK

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

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

Android SDK、iOS SDK、ウェブ SDK の使用にあたっては、Cloud Firestore を使ってみるをご覧ください。

リファレンスとリソース

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

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

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

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

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

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

Firebase Admin SDK

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

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

リファレンスとリソース

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

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

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

リファレンスとリソース

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

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

Cloud Firestore は、モバイル SDK とウェブ SDK、およびサーバー クライアント ライブラリに加えて、いくつかのオープンソース ライブラリとの統合を提供しています。ライブラリとフレームワークの統合をご覧ください。