複数のドキュメントを取得します。
このメソッドで返されるドキュメントは、リクエストされた順序で返されるとは限りません。
HTTP リクエスト
POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:batchGet
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
database |
必須。データベース名。形式は |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "documents": [ string ], "mask": { object ( |
フィールド | |
---|---|
documents[] |
取得するドキュメントの名前。形式は |
mask |
返されるフィールド。設定されていない場合は、すべてのフィールドが返されます。 このマスクに存在しないフィールドがドキュメントにある場合、そのフィールドはレスポンスで返されません。 |
共用体フィールド consistency_selector 。このトランザクションの整合性モード。設定しない場合、デフォルトで強整合性が使用されます。consistency_selector は次のいずれかになります。 |
|
transaction |
トランザクション内のドキュメントを読み取ります。 Base64 でエンコードされた文字列。 |
newTransaction |
新しいトランザクションを開始し、ドキュメントを読み取ります。デフォルトは読み取り専用トランザクションです。新しいトランザクション ID は、ストリーム内の最初のレスポンスとして返されます。 |
readTime |
指定された時点のドキュメントを読み取ります。 これは、過去 1 時間以内のマイクロ秒の精度のタイムスタンプにする必要があります。ポイントインタイム リカバリが有効になっている場合は、過去 7 日間以内の 1 分単位のタイムスタンプにすることもできます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
レスポンスの本文
Firestore.BatchGetDocuments
のストリーミングされたレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "transaction": string, "readTime": string, // Union field |
フィールド | |
---|---|
transaction |
このリクエストの一部として開始されたトランザクション。リクエストで Base64 でエンコードされた文字列。 |
readTime |
ドキュメントが読み取られた時刻。これは単数に増加する可能性があります。この場合、結果ストリームの以前のドキュメントが readTime とこのドキュメントの間で変更されていないことが保証されます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
共用体フィールド result 。単一の結果。サーバーがトランザクションを返すだけの場合は空にできます。result は次のいずれかになります。 |
|
found |
リクエストされたドキュメント。 |
missing |
リクエストされたドキュメント名が存在しない。形式は |
承認スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
詳細については、認証の概要をご覧ください。