list method
Lists documents.
Request parameters:
parent
- Required. The parent resource name. In the format:
projects/{project_id}/databases/{database_id}/documents
or
projects/{project_id}/databases/{database_id}/documents/{document_path}
.
For example: projects/my-project/databases/my-database/documents
or
projects/my-project/databases/my-database/documents/chatrooms/my-chatroom
Value must have pattern
^projects/\[^/\]+/databases/\[^/\]+/documents/\[^/\]+/.*$
.
collectionId
- Optional. The collection ID, relative to parent
, to
list. For example: chatrooms
or messages
. This is optional, and when
not provided, Firestore will list documents from all collections under the
provided parent
.
mask_fieldPaths
- The list of field paths in the mask. See
Document.fields for a field path syntax reference.
orderBy
- Optional. The optional ordering of the documents to return.
For example: priority desc, __name__ desc
. This mirrors the ORDER BY
used in Firestore queries but in a string representation. When absent,
documents are ordered based on __name__ ASC
.
pageSize
- Optional. The maximum number of documents to return in a
single response. Firestore may return fewer than this value.
pageToken
- Optional. A page token, received from a previous
ListDocuments
response. Provide this to retrieve the subsequent page.
When paginating, all other parameters (with the exception of page_size
)
must match the values set in the request that generated the page token.
readTime
- Perform the read at the provided time. This must be a
microsecond precision timestamp within the past one hour, or if
Point-in-Time Recovery is enabled, can additionally be a whole minute
timestamp within the past 7 days.
showMissing
- If the list should show missing documents. A document is
missing if it does not exist, but there are sub-documents nested
underneath it. When true, such missing documents will be returned with a
key but will not have fields, create_time
, or update_time
set.
Requests with show_missing
may not specify where
or order_by
.
transaction
- Perform the read as part of an already active transaction.
$fields
- Selector specifying which fields to include in a partial
response.
Completes with a ListDocumentsResponse.
Completes with a commons.ApiRequestError if the API endpoint returned an error.
If the used http.Client
completes with an error when making a REST call,
this method will complete with the same error.
Implementation
async.Future<ListDocumentsResponse> list(
core.String parent,
core.String collectionId, {
core.List<core.String>? mask_fieldPaths,
core.String? orderBy,
core.int? pageSize,
core.String? pageToken,
core.String? readTime,
core.bool? showMissing,
core.String? transaction,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (mask_fieldPaths != null) 'mask.fieldPaths': mask_fieldPaths,
if (orderBy != null) 'orderBy': [orderBy],
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if (readTime != null) 'readTime': [readTime],
if (showMissing != null) 'showMissing': ['${showMissing}'],
if (transaction != null) 'transaction': [transaction],
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v1/' +
core.Uri.encodeFull('$parent') +
'/' +
commons.escapeVariable('$collectionId');
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListDocumentsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>);
}