Reference documentation and code samples for the Cloud Firestore V1 Client class Document.
A Firestore document.
Must not exceed 1 MiB - 4 bytes.
Generated from protobuf message google.firestore.v1.Document
Namespace
Google \ Cloud \ Firestore \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ name
string
The resource name of the document, for example projects/{project_id}/databases/{database_id}/documents/{document_path}
.
↳ fields
array| Google\Protobuf\Internal\MapField
The document's fields. The map keys represent field names. Field names matching the regular expression __.*__
are reserved. Reserved field names are forbidden except in certain documented contexts. The field names, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty. Field paths may be used in other contexts to refer to structured fields defined here. For map_value
, the field path is represented by a dot-delimited ( .
) string of segments. Each segment is either a simple field name (defined below) or a quoted field name. For example, the structured field "foo" : { map_value: { "x&y" : { string_value: "hello" }}}
would be represented by the field path foo.`x&y`
. A simple field name contains only characters a
to z
, A
to Z
, 0
to 9
, or _
, and must not start with 0
to 9
. For example, foo_bar_17
. A quoted field name starts and ends with `
and may contain any character. Some characters, including `
, must be escaped using a \
. For example, `x&y`
represents x&y
and `bak\`tik`
represents bak`tik
.
↳ create_time
Google\Protobuf\Timestamp
Output only. The time at which the document was created. This value increases monotonically when a document is deleted then recreated. It can also be compared to values from other documents and the read_time
of a query.
↳ update_time
Google\Protobuf\Timestamp
Output only. The time at which the document was last changed. This value is initially set to the create_time
then increases monotonically with each change to the document. It can also be compared to values from other documents and the read_time
of a query.
getName
The resource name of the document, for example projects/{project_id}/databases/{database_id}/documents/{document_path}
.
string
setName
The resource name of the document, for example projects/{project_id}/databases/{database_id}/documents/{document_path}
.
var
string
$this
getFields
The document's fields.
The map keys represent field names.
Field names matching the regular expression __.*__
are reserved. Reserved
field names are forbidden except in certain documented contexts. The field
names, represented as UTF-8, must not exceed 1,500 bytes and cannot be
empty.
Field paths may be used in other contexts to refer to structured fields
defined here. For map_value
, the field path is represented by a
dot-delimited ( .
) string of segments. Each segment is either a simple
field name (defined below) or a quoted field name. For example, the
structured field "foo" : { map_value: { "x&y" : { string_value: "hello"
}}}
would be represented by the field path foo.`x&y`
.
A simple field name contains only characters a
to z
, A
to Z
, 0
to 9
, or _
, and must not start with 0
to 9
. For example, foo_bar_17
.
A quoted field name starts and ends with `
and
may contain any character. Some characters, including `
, must be
escaped using a \
. For example, `x&y`
represents x&y
and `bak\`tik`
represents bak`tik
.
setFields
The document's fields.
The map keys represent field names.
Field names matching the regular expression __.*__
are reserved. Reserved
field names are forbidden except in certain documented contexts. The field
names, represented as UTF-8, must not exceed 1,500 bytes and cannot be
empty.
Field paths may be used in other contexts to refer to structured fields
defined here. For map_value
, the field path is represented by a
dot-delimited ( .
) string of segments. Each segment is either a simple
field name (defined below) or a quoted field name. For example, the
structured field "foo" : { map_value: { "x&y" : { string_value: "hello"
}}}
would be represented by the field path foo.`x&y`
.
A simple field name contains only characters a
to z
, A
to Z
, 0
to 9
, or _
, and must not start with 0
to 9
. For example, foo_bar_17
.
A quoted field name starts and ends with `
and
may contain any character. Some characters, including `
, must be
escaped using a \
. For example, `x&y`
represents x&y
and `bak\`tik`
represents bak`tik
.
$this
getCreateTime
Output only. The time at which the document was created.
This value increases monotonically when a document is deleted then
recreated. It can also be compared to values from other documents and
the read_time
of a query.
hasCreateTime
clearCreateTime
setCreateTime
Output only. The time at which the document was created.
This value increases monotonically when a document is deleted then
recreated. It can also be compared to values from other documents and
the read_time
of a query.
$this
getUpdateTime
Output only. The time at which the document was last changed.
This value is initially set to the create_time
then increases
monotonically with each change to the document. It can also be
compared to values from other documents and the read_time
of a query.
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. The time at which the document was last changed.
This value is initially set to the create_time
then increases
monotonically with each change to the document. It can also be
compared to values from other documents and the read_time
of a query.
$this
