Module base_document (2.17.0)

Classes for representing documents for the Google Cloud Firestore API.

Classes

BaseDocumentReference

BaseDocumentReference(*path, **kwargs)

A reference to a document in a Firestore database.

The document may already exist or can be created by this class.

Parameters
Name Description
path Tuple[str, ...]

The components in the document path. This is a series of strings representing each collection and sub-collection ID, as well as the document IDs for any documents that contain a sub-collection (as well as the base document).

kwargs dict

The keyword arguments for the constructor. The only supported keyword is client and it must be a Client. It represents the client that created this document reference.

Exceptions
Type Description
ValueError if * the path is empty * there are an even number of elements * a collection ID in path is not a string * a document ID in path is not a string
TypeError If a keyword other than client is used.

DocumentSnapshot

DocumentSnapshot(reference, data, exists, read_time, create_time, update_time)

A snapshot of document data in a Firestore database.

This represents data retrieved at a specific time and may not contain all fields stored for the document (i.e. a hand-picked selection of fields may have been retrieved).

Instances of this class are not intended to be constructed by hand, rather they'll be returned as responses to various methods, such as xref_get.

Parameters
Name Description
reference DocumentReference

A document reference corresponding to the document that contains the data in this snapshot.

data Dict[str, Any]

The data retrieved in the snapshot.

exists bool

Indicates if the document existed at the time the snapshot was retrieved.

read_time proto.datetime_helpers.DatetimeWithNanoseconds

The time that this snapshot was read from the server.

create_time proto.datetime_helpers.DatetimeWithNanoseconds

The time that this document was created.

update_time proto.datetime_helpers.DatetimeWithNanoseconds

The time that this document was last updated.