Firestore v1 API - Class ListDocumentsRequest (3.9.0)

public sealed class ListDocumentsRequest : IMessage<ListDocumentsRequest>, IEquatable<ListDocumentsRequest>, IDeepCloneable<ListDocumentsRequest>, IBufferMessage, IMessage, IPageRequest

Reference documentation and code samples for the Firestore v1 API class ListDocumentsRequest.

The request for [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].

Inheritance

object > ListDocumentsRequest

Namespace

Google.Cloud.Firestore.V1

Assembly

Google.Cloud.Firestore.V1.dll

Constructors

ListDocumentsRequest()

public ListDocumentsRequest()

ListDocumentsRequest(ListDocumentsRequest)

public ListDocumentsRequest(ListDocumentsRequest other)
Parameter
Name Description
other ListDocumentsRequest

Properties

CollectionId

public string CollectionId { get; set; }

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.

Property Value
Type Description
string

ConsistencySelectorCase

public ListDocumentsRequest.ConsistencySelectorOneofCase ConsistencySelectorCase { get; }
Property Value
Type Description
ListDocumentsRequestConsistencySelectorOneofCase

HasTransaction

public bool HasTransaction { get; }

Gets whether the "transaction" field is set

Property Value
Type Description
bool

Mask

public DocumentMask Mask { get; set; }

Optional. The fields to return. If not set, returns all fields.

If a document has a field that is not present in this mask, that field will not be returned in the response.

Property Value
Type Description
DocumentMask

OrderBy

public string OrderBy { get; set; }

Optional. The optional ordering of the documents to return.

For example: priority desc, __name__ desc.

This mirrors the [ORDER BY][google.firestore.v1.StructuredQuery.order_by] used in Firestore queries but in a string representation. When absent, documents are ordered based on __name__ ASC.

Property Value
Type Description
string

PageSize

public int PageSize { get; set; }

Optional. The maximum number of documents to return in a single response.

Firestore may return fewer than this value.

Property Value
Type Description
int

PageToken

public string PageToken { get; set; }

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.

Property Value
Type Description
string

Parent

public string Parent { get; set; }

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

Property Value
Type Description
string

ReadTime

public Timestamp ReadTime { get; set; }

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.

Property Value
Type Description
Timestamp

ShowMissing

public bool ShowMissing { get; set; }

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][google.firestore.v1.Document.create_time], or [update_time][google.firestore.v1.Document.update_time] set.

Requests with show_missing may not specify where or order_by.

Property Value
Type Description
bool

Transaction

public ByteString Transaction { get; set; }

Perform the read as part of an already active transaction.

Property Value
Type Description
ByteString