public static final class BatchGetDocumentsRequest.Builder extends GeneratedMessageV3.Builder<BatchGetDocumentsRequest.Builder> implements BatchGetDocumentsRequestOrBuilderThe request for Firestore.BatchGetDocuments.
Protobuf type google.firestore.v1.BatchGetDocumentsRequest
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > BatchGetDocumentsRequest.BuilderImplements
BatchGetDocumentsRequestOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
Methods
addAllDocuments(Iterable<String> values)
public BatchGetDocumentsRequest.Builder addAllDocuments(Iterable<String> values) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<String>The documents to add. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
addDocuments(String value)
public BatchGetDocumentsRequest.Builder addDocuments(String value) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe documents to add. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
addDocumentsBytes(ByteString value)
public BatchGetDocumentsRequest.Builder addDocumentsBytes(ByteString value) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes of the documents to add. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public BatchGetDocumentsRequest.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
build()
public BatchGetDocumentsRequest build()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest |
|
buildPartial()
public BatchGetDocumentsRequest buildPartial()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest |
|
clear()
public BatchGetDocumentsRequest.Builder clear()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearConsistencySelector()
public BatchGetDocumentsRequest.Builder clearConsistencySelector()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearDatabase()
public BatchGetDocumentsRequest.Builder clearDatabase() Required. The database name. In the format:
projects/{project_id}/databases/{database_id}.
string database = 1 [(.google.api.field_behavior) = REQUIRED];
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
clearDocuments()
public BatchGetDocumentsRequest.Builder clearDocuments() The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
clearField(Descriptors.FieldDescriptor field)
public BatchGetDocumentsRequest.Builder clearField(Descriptors.FieldDescriptor field)| Parameter | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearMask()
public BatchGetDocumentsRequest.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 = 3;
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearNewTransaction()
public BatchGetDocumentsRequest.Builder clearNewTransaction()Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearOneof(Descriptors.OneofDescriptor oneof)
public BatchGetDocumentsRequest.Builder clearOneof(Descriptors.OneofDescriptor oneof)| Parameter | |
|---|---|
| Name | Description |
oneof |
OneofDescriptor |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearReadTime()
public BatchGetDocumentsRequest.Builder clearReadTime()Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
clearTransaction()
public BatchGetDocumentsRequest.Builder clearTransaction()Reads documents in a transaction.
bytes transaction = 4;
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
clone()
public BatchGetDocumentsRequest.Builder clone()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
getConsistencySelectorCase()
public BatchGetDocumentsRequest.ConsistencySelectorCase getConsistencySelectorCase()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.ConsistencySelectorCase |
|
getDatabase()
public String getDatabase() Required. The database name. In the format:
projects/{project_id}/databases/{database_id}.
string database = 1 [(.google.api.field_behavior) = REQUIRED];
| Returns | |
|---|---|
| Type | Description |
String |
The database. |
getDatabaseBytes()
public ByteString getDatabaseBytes() Required. The database name. In the format:
projects/{project_id}/databases/{database_id}.
string database = 1 [(.google.api.field_behavior) = REQUIRED];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for database. |
getDefaultInstanceForType()
public BatchGetDocumentsRequest getDefaultInstanceForType()| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest |
|
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
getDocuments(int index)
public String getDocuments(int index) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the element to return. |
| Returns | |
|---|---|
| Type | Description |
String |
The documents at the given index. |
getDocumentsBytes(int index)
public ByteString getDocumentsBytes(int index) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the value to return. |
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes of the documents at the given index. |
getDocumentsCount()
public int getDocumentsCount() The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Returns | |
|---|---|
| Type | Description |
int |
The count of documents. |
getDocumentsList()
public ProtocolStringList getDocumentsList() The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Returns | |
|---|---|
| Type | Description |
ProtocolStringList |
A list containing the documents. |
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 = 3;
| Returns | |
|---|---|
| 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 = 3;
| Returns | |
|---|---|
| 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 = 3;
| Returns | |
|---|---|
| Type | Description |
DocumentMaskOrBuilder |
|
getNewTransaction()
public TransactionOptions getNewTransaction()Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Returns | |
|---|---|
| Type | Description |
TransactionOptions |
The newTransaction. |
getNewTransactionBuilder()
public TransactionOptions.Builder getNewTransactionBuilder()Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Returns | |
|---|---|
| Type | Description |
TransactionOptions.Builder |
|
getNewTransactionOrBuilder()
public TransactionOptionsOrBuilder getNewTransactionOrBuilder()Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Returns | |
|---|---|
| Type | Description |
TransactionOptionsOrBuilder |
|
getReadTime()
public Timestamp getReadTime()Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Returns | |
|---|---|
| Type | Description |
Timestamp |
The readTime. |
getReadTimeBuilder()
public Timestamp.Builder getReadTimeBuilder()Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Returns | |
|---|---|
| Type | Description |
Builder |
|
getReadTimeOrBuilder()
public TimestampOrBuilder getReadTimeOrBuilder()Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Returns | |
|---|---|
| Type | Description |
TimestampOrBuilder |
|
getTransaction()
public ByteString getTransaction()Reads documents in a transaction.
bytes transaction = 4;
| Returns | |
|---|---|
| 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 = 3;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the mask field is set. |
hasNewTransaction()
public boolean hasNewTransaction()Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the newTransaction field is set. |
hasReadTime()
public boolean hasReadTime()Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the readTime field is set. |
hasTransaction()
public boolean hasTransaction()Reads documents in a transaction.
bytes transaction = 4;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the transaction field is set. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()| Returns | |
|---|---|
| Type | Description |
FieldAccessorTable |
|
isInitialized()
public final boolean isInitialized()| Returns | |
|---|---|
| Type | Description |
boolean |
|
mergeFrom(BatchGetDocumentsRequest other)
public BatchGetDocumentsRequest.Builder mergeFrom(BatchGetDocumentsRequest other)| Parameter | |
|---|---|
| Name | Description |
other |
BatchGetDocumentsRequest |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public BatchGetDocumentsRequest.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)| Parameters | |
|---|---|
| Name | Description |
input |
CodedInputStream |
extensionRegistry |
ExtensionRegistryLite |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
mergeFrom(Message other)
public BatchGetDocumentsRequest.Builder mergeFrom(Message other)| Parameter | |
|---|---|
| Name | Description |
other |
Message |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
mergeMask(DocumentMask value)
public BatchGetDocumentsRequest.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 = 3;
| Parameter | |
|---|---|
| Name | Description |
value |
DocumentMask |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
mergeNewTransaction(TransactionOptions value)
public BatchGetDocumentsRequest.Builder mergeNewTransaction(TransactionOptions value)Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Parameter | |
|---|---|
| Name | Description |
value |
TransactionOptions |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
mergeReadTime(Timestamp value)
public BatchGetDocumentsRequest.Builder mergeReadTime(Timestamp value)Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
mergeUnknownFields(UnknownFieldSet unknownFields)
public final BatchGetDocumentsRequest.Builder mergeUnknownFields(UnknownFieldSet unknownFields)| Parameter | |
|---|---|
| Name | Description |
unknownFields |
UnknownFieldSet |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setDatabase(String value)
public BatchGetDocumentsRequest.Builder setDatabase(String value) Required. The database name. In the format:
projects/{project_id}/databases/{database_id}.
string database = 1 [(.google.api.field_behavior) = REQUIRED];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe database to set. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
setDatabaseBytes(ByteString value)
public BatchGetDocumentsRequest.Builder setDatabaseBytes(ByteString value) Required. The database name. In the format:
projects/{project_id}/databases/{database_id}.
string database = 1 [(.google.api.field_behavior) = REQUIRED];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for database to set. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
setDocuments(int index, String value)
public BatchGetDocumentsRequest.Builder setDocuments(int index, String value) The names of the documents to retrieve. In the format:
projects/{project_id}/databases/{database_id}/documents/{document_path}.
The request will fail if any of the document is not a child resource of the
given database. Duplicate names will be elided.
repeated string documents = 2;
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
StringThe documents to set. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
setField(Descriptors.FieldDescriptor field, Object value)
public BatchGetDocumentsRequest.Builder setField(Descriptors.FieldDescriptor field, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setMask(DocumentMask value)
public BatchGetDocumentsRequest.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 = 3;
| Parameter | |
|---|---|
| Name | Description |
value |
DocumentMask |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setMask(DocumentMask.Builder builderForValue)
public BatchGetDocumentsRequest.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 = 3;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
DocumentMask.Builder |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setNewTransaction(TransactionOptions value)
public BatchGetDocumentsRequest.Builder setNewTransaction(TransactionOptions value)Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Parameter | |
|---|---|
| Name | Description |
value |
TransactionOptions |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setNewTransaction(TransactionOptions.Builder builderForValue)
public BatchGetDocumentsRequest.Builder setNewTransaction(TransactionOptions.Builder builderForValue)Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream.
.google.firestore.v1.TransactionOptions new_transaction = 5;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
TransactionOptions.Builder |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setReadTime(Timestamp value)
public BatchGetDocumentsRequest.Builder setReadTime(Timestamp value)Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setReadTime(Timestamp.Builder builderForValue)
public BatchGetDocumentsRequest.Builder setReadTime(Timestamp.Builder builderForValue)Reads documents as they were at the given 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.
.google.protobuf.Timestamp read_time = 7;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Builder |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public BatchGetDocumentsRequest.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)| Parameters | |
|---|---|
| Name | Description |
field |
FieldDescriptor |
index |
int |
value |
Object |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|
setTransaction(ByteString value)
public BatchGetDocumentsRequest.Builder setTransaction(ByteString value)Reads documents in a transaction.
bytes transaction = 4;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe transaction to set. |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
This builder for chaining. |
setUnknownFields(UnknownFieldSet unknownFields)
public final BatchGetDocumentsRequest.Builder setUnknownFields(UnknownFieldSet unknownFields)| Parameter | |
|---|---|
| Name | Description |
unknownFields |
UnknownFieldSet |
| Returns | |
|---|---|
| Type | Description |
BatchGetDocumentsRequest.Builder |
|