public static final class ListDocumentsRequest.Builder extends GeneratedMessageV3.Builder<ListDocumentsRequest.Builder> implements ListDocumentsRequestOrBuilder
The request for Firestore.ListDocuments.
Protobuf type google.firestore.v1.ListDocumentsRequest
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > ListDocumentsRequest.BuilderImplements
ListDocumentsRequestOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Type | Description |
Descriptor |
Methods
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public ListDocumentsRequest.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Name | Description |
field | FieldDescriptor |
value | Object |
Type | Description |
ListDocumentsRequest.Builder |
build()
public ListDocumentsRequest build()
Type | Description |
ListDocumentsRequest |
buildPartial()
public ListDocumentsRequest buildPartial()
Type | Description |
ListDocumentsRequest |
clear()
public ListDocumentsRequest.Builder clear()
Type | Description |
ListDocumentsRequest.Builder |
clearCollectionId()
public ListDocumentsRequest.Builder clearCollectionId()
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string collection_id = 2 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearConsistencySelector()
public ListDocumentsRequest.Builder clearConsistencySelector()
Type | Description |
ListDocumentsRequest.Builder |
clearField(Descriptors.FieldDescriptor field)
public ListDocumentsRequest.Builder clearField(Descriptors.FieldDescriptor field)
Name | Description |
field | FieldDescriptor |
Type | Description |
ListDocumentsRequest.Builder |
clearMask()
public ListDocumentsRequest.Builder clearMask()
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.
.google.firestore.v1.DocumentMask mask = 7;
Type | Description |
ListDocumentsRequest.Builder |
clearOneof(Descriptors.OneofDescriptor oneof)
public ListDocumentsRequest.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Name | Description |
oneof | OneofDescriptor |
Type | Description |
ListDocumentsRequest.Builder |
clearOrderBy()
public ListDocumentsRequest.Builder clearOrderBy()
The order to sort results by. For example: priority desc, name
.
string order_by = 6;
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearPageSize()
public ListDocumentsRequest.Builder clearPageSize()
The maximum number of documents to return.
int32 page_size = 3;
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearPageToken()
public ListDocumentsRequest.Builder clearPageToken()
The next_page_token
value returned from a previous List request, if any.
string page_token = 4;
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearParent()
public ListDocumentsRequest.Builder clearParent()
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
string parent = 1 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearReadTime()
public ListDocumentsRequest.Builder clearReadTime()
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Type | Description |
ListDocumentsRequest.Builder |
clearShowMissing()
public ListDocumentsRequest.Builder clearShowMissing()
If the list should show missing documents. A missing document is a
document that does not exist but has sub-documents. These documents will
be returned with a key but will not have fields, Document.create_time,
or Document.update_time set.
Requests with show_missing
may not specify where
or
order_by
.
bool show_missing = 12;
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clearTransaction()
public ListDocumentsRequest.Builder clearTransaction()
Reads documents in a transaction.
bytes transaction = 8;
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
clone()
public ListDocumentsRequest.Builder clone()
Type | Description |
ListDocumentsRequest.Builder |
getCollectionId()
public String getCollectionId()
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string collection_id = 2 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
String | The collectionId. |
getCollectionIdBytes()
public ByteString getCollectionIdBytes()
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string collection_id = 2 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
ByteString | The bytes for collectionId. |
getConsistencySelectorCase()
public ListDocumentsRequest.ConsistencySelectorCase getConsistencySelectorCase()
Type | Description |
ListDocumentsRequest.ConsistencySelectorCase |
getDefaultInstanceForType()
public ListDocumentsRequest getDefaultInstanceForType()
Type | Description |
ListDocumentsRequest |
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()
Type | Description |
Descriptor |
getMask()
public DocumentMask getMask()
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.
.google.firestore.v1.DocumentMask mask = 7;
Type | Description |
DocumentMask | The mask. |
getMaskBuilder()
public DocumentMask.Builder getMaskBuilder()
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.
.google.firestore.v1.DocumentMask mask = 7;
Type | Description |
DocumentMask.Builder |
getMaskOrBuilder()
public DocumentMaskOrBuilder getMaskOrBuilder()
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.
.google.firestore.v1.DocumentMask mask = 7;
Type | Description |
DocumentMaskOrBuilder |
getOrderBy()
public String getOrderBy()
The order to sort results by. For example: priority desc, name
.
string order_by = 6;
Type | Description |
String | The orderBy. |
getOrderByBytes()
public ByteString getOrderByBytes()
The order to sort results by. For example: priority desc, name
.
string order_by = 6;
Type | Description |
ByteString | The bytes for orderBy. |
getPageSize()
public int getPageSize()
The maximum number of documents to return.
int32 page_size = 3;
Type | Description |
int | The pageSize. |
getPageToken()
public String getPageToken()
The next_page_token
value returned from a previous List request, if any.
string page_token = 4;
Type | Description |
String | The pageToken. |
getPageTokenBytes()
public ByteString getPageTokenBytes()
The next_page_token
value returned from a previous List request, if any.
string page_token = 4;
Type | Description |
ByteString | The bytes for pageToken. |
getParent()
public String getParent()
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
string parent = 1 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
String | The parent. |
getParentBytes()
public ByteString getParentBytes()
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
string parent = 1 [(.google.api.field_behavior) = REQUIRED];
Type | Description |
ByteString | The bytes for parent. |
getReadTime()
public Timestamp getReadTime()
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Type | Description |
Timestamp | The readTime. |
getReadTimeBuilder()
public Timestamp.Builder getReadTimeBuilder()
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Type | Description |
Builder |
getReadTimeOrBuilder()
public TimestampOrBuilder getReadTimeOrBuilder()
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Type | Description |
TimestampOrBuilder |
getShowMissing()
public boolean getShowMissing()
If the list should show missing documents. A missing document is a
document that does not exist but has sub-documents. These documents will
be returned with a key but will not have fields, Document.create_time,
or Document.update_time set.
Requests with show_missing
may not specify where
or
order_by
.
bool show_missing = 12;
Type | Description |
boolean | The showMissing. |
getTransaction()
public ByteString getTransaction()
Reads documents in a transaction.
bytes transaction = 8;
Type | Description |
ByteString | The transaction. |
hasMask()
public boolean hasMask()
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.
.google.firestore.v1.DocumentMask mask = 7;
Type | Description |
boolean | Whether the mask field is set. |
hasReadTime()
public boolean hasReadTime()
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Type | Description |
boolean | Whether the readTime field is set. |
hasTransaction()
public boolean hasTransaction()
Reads documents in a transaction.
bytes transaction = 8;
Type | Description |
boolean | Whether the transaction field is set. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Type | Description |
FieldAccessorTable |
isInitialized()
public final boolean isInitialized()
Type | Description |
boolean |
mergeFrom(ListDocumentsRequest other)
public ListDocumentsRequest.Builder mergeFrom(ListDocumentsRequest other)
Name | Description |
other | ListDocumentsRequest |
Type | Description |
ListDocumentsRequest.Builder |
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public ListDocumentsRequest.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Name | Description |
input | CodedInputStream |
extensionRegistry | ExtensionRegistryLite |
Type | Description |
ListDocumentsRequest.Builder |
Type | Description |
IOException |
mergeFrom(Message other)
public ListDocumentsRequest.Builder mergeFrom(Message other)
Name | Description |
other | Message |
Type | Description |
ListDocumentsRequest.Builder |
mergeMask(DocumentMask value)
public ListDocumentsRequest.Builder mergeMask(DocumentMask value)
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.
.google.firestore.v1.DocumentMask mask = 7;
Name | Description |
value | DocumentMask |
Type | Description |
ListDocumentsRequest.Builder |
mergeReadTime(Timestamp value)
public ListDocumentsRequest.Builder mergeReadTime(Timestamp value)
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Name | Description |
value | Timestamp |
Type | Description |
ListDocumentsRequest.Builder |
mergeUnknownFields(UnknownFieldSet unknownFields)
public final ListDocumentsRequest.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Name | Description |
unknownFields | UnknownFieldSet |
Type | Description |
ListDocumentsRequest.Builder |
setCollectionId(String value)
public ListDocumentsRequest.Builder setCollectionId(String value)
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string collection_id = 2 [(.google.api.field_behavior) = REQUIRED];
Name | Description |
value | String The collectionId to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setCollectionIdBytes(ByteString value)
public ListDocumentsRequest.Builder setCollectionIdBytes(ByteString value)
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string collection_id = 2 [(.google.api.field_behavior) = REQUIRED];
Name | Description |
value | ByteString The bytes for collectionId to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setField(Descriptors.FieldDescriptor field, Object value)
public ListDocumentsRequest.Builder setField(Descriptors.FieldDescriptor field, Object value)
Name | Description |
field | FieldDescriptor |
value | Object |
Type | Description |
ListDocumentsRequest.Builder |
setMask(DocumentMask value)
public ListDocumentsRequest.Builder setMask(DocumentMask value)
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.
.google.firestore.v1.DocumentMask mask = 7;
Name | Description |
value | DocumentMask |
Type | Description |
ListDocumentsRequest.Builder |
setMask(DocumentMask.Builder builderForValue)
public ListDocumentsRequest.Builder setMask(DocumentMask.Builder builderForValue)
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.
.google.firestore.v1.DocumentMask mask = 7;
Name | Description |
builderForValue | DocumentMask.Builder |
Type | Description |
ListDocumentsRequest.Builder |
setOrderBy(String value)
public ListDocumentsRequest.Builder setOrderBy(String value)
The order to sort results by. For example: priority desc, name
.
string order_by = 6;
Name | Description |
value | String The orderBy to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setOrderByBytes(ByteString value)
public ListDocumentsRequest.Builder setOrderByBytes(ByteString value)
The order to sort results by. For example: priority desc, name
.
string order_by = 6;
Name | Description |
value | ByteString The bytes for orderBy to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setPageSize(int value)
public ListDocumentsRequest.Builder setPageSize(int value)
The maximum number of documents to return.
int32 page_size = 3;
Name | Description |
value | int The pageSize to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setPageToken(String value)
public ListDocumentsRequest.Builder setPageToken(String value)
The next_page_token
value returned from a previous List request, if any.
string page_token = 4;
Name | Description |
value | String The pageToken to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setPageTokenBytes(ByteString value)
public ListDocumentsRequest.Builder setPageTokenBytes(ByteString value)
The next_page_token
value returned from a previous List request, if any.
string page_token = 4;
Name | Description |
value | ByteString The bytes for pageToken to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setParent(String value)
public ListDocumentsRequest.Builder setParent(String value)
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
string parent = 1 [(.google.api.field_behavior) = REQUIRED];
Name | Description |
value | String The parent to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setParentBytes(ByteString value)
public ListDocumentsRequest.Builder setParentBytes(ByteString value)
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
string parent = 1 [(.google.api.field_behavior) = REQUIRED];
Name | Description |
value | ByteString The bytes for parent to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setReadTime(Timestamp value)
public ListDocumentsRequest.Builder setReadTime(Timestamp value)
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Name | Description |
value | Timestamp |
Type | Description |
ListDocumentsRequest.Builder |
setReadTime(Timestamp.Builder builderForValue)
public ListDocumentsRequest.Builder setReadTime(Timestamp.Builder builderForValue)
Reads documents as they were at the given time. This may not be older than 270 seconds.
.google.protobuf.Timestamp read_time = 10;
Name | Description |
builderForValue | Builder |
Type | Description |
ListDocumentsRequest.Builder |
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public ListDocumentsRequest.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Name | Description |
field | FieldDescriptor |
index | int |
value | Object |
Type | Description |
ListDocumentsRequest.Builder |
setShowMissing(boolean value)
public ListDocumentsRequest.Builder setShowMissing(boolean value)
If the list should show missing documents. A missing document is a
document that does not exist but has sub-documents. These documents will
be returned with a key but will not have fields, Document.create_time,
or Document.update_time set.
Requests with show_missing
may not specify where
or
order_by
.
bool show_missing = 12;
Name | Description |
value | boolean The showMissing to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setTransaction(ByteString value)
public ListDocumentsRequest.Builder setTransaction(ByteString value)
Reads documents in a transaction.
bytes transaction = 8;
Name | Description |
value | ByteString The transaction to set. |
Type | Description |
ListDocumentsRequest.Builder | This builder for chaining. |
setUnknownFields(UnknownFieldSet unknownFields)
public final ListDocumentsRequest.Builder setUnknownFields(UnknownFieldSet unknownFields)
Name | Description |
unknownFields | UnknownFieldSet |
Type | Description |
ListDocumentsRequest.Builder |