Import ErrorAll platformsPython 3.8 · 3.9 · 3.10 · 3.11

ImportError: cannot import name 'firestore' from 'google.events.cloud'

pip install google-events
>>> from google.events.cloud import firestore
ImportError: cannot import name 'firestore' from 'google.events.cloud'
# Also fails:
>>> from google.events.cloud.firestore.v1 import DocumentEventData
ModuleNotFoundError: No module named 'google.events.cloud.firestore'
Why this happens

The google-events package structures Firestore types under google.events.cloud.firestore_v1.types, not as a top-level firestore symbol on google.events.cloud. The subpackage name uses an underscore (firestore_v1), not a dot-separated path (firestore.v1).

Observed in
Linux · Python 3.11
wrong path · failsfirestore_v1 · ok
macOS · Python 3.11
wrong path · failsfirestore_v1 · ok
Windows · Python 3.11
wrong path · failsfirestore_v1 · ok
Fixes
1Import from firestore_v1.typesEasiest

Use the full path with firestore_v1 (underscore, not dot) and reach into the .types submodule for the DocumentEventData class.

from google.events.cloud.firestore_v1.types import DocumentEventData

# parse a CloudEvent payload
data = DocumentEventData()
data._pb.MergeFromString(event.data)
2Import directly from firestore_v1 moduleEasy

The types module re-exports DocumentEventData at the firestore_v1 level as well.

from google.events.cloud.firestore_v1 import DocumentEventData
google-events · Compatibility Matrix
See install results across all Python versions and operating systems
→
Observed in 402 searches · Last verified Aug 2026
ImportError: cannot import name 'firestore' from 'google.events.cloud' — google-events