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。 たとえば、chatrooms や messages です。 これは省略可能です。指定しない場合、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 の場合、このような欠落したドキュメントはキーとともに返されますが、フィールド、createTime 、updateTime は設定されません。 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
詳細については、認証の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-04-12 UTC。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"必要な情報がない"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"複雑すぎる / 手順が多すぎる"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"最新ではない"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻訳に関する問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"サンプル / コードに問題がある"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"その他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"わかりやすい"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"問題の解決に役立った"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"その他"
}]