Reference documentation and code samples for the Cloud Firestore V1 Client class ListDocumentsRequest.
The request for Firestore.ListDocuments .
Generated from protobuf message google.firestore.v1.ListDocumentsRequest
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ parent
string
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
↳ collection_id
string
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
↳ page_size
int
The maximum number of documents to return.
↳ page_token
string
The next_page_token
value returned from a previous List request, if any.
↳ order_by
string
The order to sort results by. For example: priority desc, name
.
↳ 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.
↳ read_time
Google\Protobuf\Timestamp
Reads documents as they were at the given time. This may not be older than 270 seconds.
↳ show_missing
bool
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
.
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
setParent
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
var
string
$this
getCollectionId
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
string
setCollectionId
Required. The collection ID, relative to parent
, to list. For example: chatrooms
or messages
.
var
string
$this
getPageSize
The maximum number of documents to return.
int
setPageSize
The maximum number of documents to return.
var
int
$this
getPageToken
The next_page_token
value returned from a previous List request, if any.
string
setPageToken
The next_page_token
value returned from a previous List request, if any.
var
string
$this
getOrderBy
The order to sort results by. For example: priority desc, name
.
string
setOrderBy
The order to sort results by. For example: priority desc, name
.
var
string
$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.
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.
$this
getTransaction
Reads documents in a transaction.
string
hasTransaction
setTransaction
Reads documents in a transaction.
var
string
$this
getReadTime
Reads documents as they were at the given time.
This may not be older than 270 seconds.
hasReadTime
setReadTime
Reads documents as they were at the given time.
This may not be older than 270 seconds.
$this
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
setShowMissing
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
.
var
bool
$this
getConsistencySelector
string