---
id: google-events
version: "0.14.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# google-events — Google Cloudevents library

License: permissive · Maintenance: active · Downloads: 627.6K/mo

## What it is and what it does

Google CloudEvents is a Python library that defines and provides classes for event types used across Google Cloud services. It wraps protobuf definitions from the Google CloudEvents repository, allowing developers to parse and work with event payloads in a type-safe manner. The library is designed primarily for use with Google Cloud Run services that receive event triggers, though it can be used anywhere CloudEvents need to be deserialized and handled.

The package depends on proto-plus and protobuf for its core functionality, translating protobuf message definitions into Python classes. It requires Python 3.7 or later and is distributed as a pure-Python wheel, making installation straightforward across platforms.

Use it for:

- Parse Cloud Storage events in Cloud Run services to react to bucket or object changes.
- Handle Pub/Sub message events received as CloudEvents in event-driven architectures.
- Deserialize and type-check event payloads from Google Cloud event sources in serverless functions.
- Build event routing logic that depends on structured event type definitions from Google services.
- Integrate with Cloud Audit Logs or other Google Cloud event streams in Python applications.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python classes for Google CloudEvents event types, enabling parsing and handling of event payloads from Google Cloud services.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a real problem for developers working with Google Cloud event-driven systems. No known vulnerabilities. Install it if you are building Cloud Run services or other Python applications that consume Google CloudEvents.

## Install

pip install google-events
uv add google-events
poetry add google-events

## Installing google-events

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained as of June 2026, with regular releases since January 2021.

License in practice: Licensed under Apache License 2.0 (permissive), allowing use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install google-events

from google.events.cloud import storage

def handle_event_trigger(json_payload):
    event = storage.StorageObjectData.from_json(json_payload)
    print(f"{event.bucket}/{event.name} had event")
    return "OK"

Requires Python 3.7 or later.

Verify before relying:

- Whether the library covers all Google Cloud event types or only a subset of available services.
- Performance characteristics when parsing large or deeply nested event payloads.
- Backward compatibility guarantees across minor version updates.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 627.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google cloud events python, cloudevents event types, google cloud event parsing, event payload handling, cloud run event triggers, google events library, cloudevents protobuf classes, google-cloud, event-handling, protobuf

[View on SkillFed](https://skillfed.io/packages/google-events) · [View on PyPI](https://pypi.org/project/google-events/)