Cloud Firestore V1 Client - Class BatchGetDocumentsRequest (1.44.1)

Reference documentation and code samples for the Cloud Firestore V1 Client class BatchGetDocumentsRequest.

The request for Firestore.BatchGetDocuments.

Generated from protobuf message google.firestore.v1.BatchGetDocumentsRequest

Namespace

Google \ Cloud \ Firestore \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ database string

Required. The database name. In the format: projects/{project_id}/databases/{database_id}.

↳ documents array

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.

↳ mask Google\Cloud\Firestore\V1\DocumentMask

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.

↳ transaction string

Reads documents in a transaction.

↳ new_transaction Google\Cloud\Firestore\V1\TransactionOptions

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.

↳ read_time Google\Protobuf\Timestamp

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.

getDatabase

Required. The database name. In the format: projects/{project_id}/databases/{database_id}.

Returns
Type Description
string

setDatabase

Required. The database name. In the format: projects/{project_id}/databases/{database_id}.

Parameter
Name Description
var string
Returns
Type Description
$this

getDocuments

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.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setDocuments

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.

Parameter
Name Description
var string[]
Returns
Type Description
$this

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.

Returns
Type Description
Google\Cloud\Firestore\V1\DocumentMask|null

hasMask

clearMask

setMask

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.

Parameter
Name Description
var Google\Cloud\Firestore\V1\DocumentMask
Returns
Type Description
$this

getTransaction

Reads documents in a transaction.

Returns
Type Description
string

hasTransaction

setTransaction

Reads documents in a transaction.

Parameter
Name Description
var string
Returns
Type Description
$this

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.

Returns
Type Description
Google\Cloud\Firestore\V1\TransactionOptions|null

hasNewTransaction

setNewTransaction

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.

Parameter
Name Description
var Google\Cloud\Firestore\V1\TransactionOptions
Returns
Type Description
$this

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.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasReadTime

setReadTime

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.

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getConsistencySelector

Returns
Type Description
string