Method: projects.databases.documents.listDocuments

ドキュメントを一覧表示します。

HTTP リクエスト

GET https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents}/{collectionId}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。親リソース名。形式は projects/{projectId}/databases/{databaseId}/documents または projects/{projectId}/databases/{databaseId}/documents/{document_path} です。

例: projects/my-project/databases/my-database/documents、または projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

collectionId

string

省略可。parent に対する相対的なリスト対象のコレクション ID。

たとえば、chatroomsmessages です。

これは省略可能です。指定しない場合、Firestore は指定された parent にあるすべてのコレクションのドキュメントを一覧表示します。

クエリ パラメータ

パラメータ
pageSize

integer

省略可。1 回のレスポンスで返すドキュメントの最大数。

Firestore はこの値より少ない数を返す場合があります。

pageToken

string

省略可。前の documents.list レスポンスから受け取ったページトークン。

これを指定して、後続のページを取得します。ページ分けを行う際、他のすべてのパラメータ(pageSize を除く)は、ページトークンを生成したリクエストに設定された値と一致する必要があります。

orderBy

string

省略可。返されるドキュメントの順序(省略可)。

例: priority desc, __name__ desc

これは、Firestore クエリで使用される ORDER BY を文字列表現でミラーリングします。指定されていない場合、ドキュメントは __name__ ASC に基づいて並べ替えられます。

mask

object (DocumentMask)

省略可。返されるフィールド。設定されていない場合は、すべてのフィールドが返されます。

このマスクに存在しないフィールドがドキュメントにある場合、そのフィールドはレスポンスで返されません。

showMissing

boolean

リストに不足している書類が表示されているかどうか。

ドキュメントが存在しないが、その下にサブドキュメントがネストされている場合、そのドキュメントは存在しない。true の場合、このような欠落したドキュメントはキーとともに返されますが、フィールド、createTimeupdateTime は設定されません。

showMissing を含むリクエストでは、where または orderBy を指定できません。

ユニオン パラメータ consistency_selector。このトランザクションの整合性モード。設定しない場合、デフォルトで強整合性が使用されます。consistency_selector は次のいずれかになります。
transaction

string (bytes format)

すでにアクティブなトランザクションの一部として読み取りを実行します。

Base64 でエンコードされた文字列。

readTime

string (Timestamp format)

指定された時刻に読み取りを実行します。

これは、過去 1 時間以内のマイクロ秒の精度のタイムスタンプにする必要があります。ポイントインタイム リカバリが有効になっている場合は、過去 7 日間以内の 1 分単位のタイムスタンプにすることもできます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には ListDocumentsResponse のインスタンスが含まれます。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。