gws-events-subscribe
Installation
Summary
Subscribe to Google Workspace events and stream them as NDJSON output.
- Connects to Workspace resources (Chat spaces, Drive, Calendar, etc.) via CloudEvents types and streams events in real-time or batch mode
- Supports Pub/Sub-backed subscriptions with configurable polling intervals, batch sizes, and optional auto-acknowledgment
- Offers flexible output modes: stream to stdout, write individual events to files, or reuse existing subscriptions for reconnection
- Includes cleanup options to remove Pub/Sub resources on exit and one-shot polling with the
--onceflag
SKILL.md
events +subscribe
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Subscribe to Workspace events and stream them as NDJSON
Usage
gws events +subscribe
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--target |
— | — | Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID) |
--event-types |
— | — | Comma-separated CloudEvents types to subscribe to |
--project |
— | — | GCP project ID for Pub/Sub resources |
Related skills
More from googleworkspace/cli
gws-gmail
Gmail: Send, read, and manage email.
26.1Kgws-docs
Read and write Google Docs.
26.0Kgws-drive
Google Drive: Manage files, folders, and shared drives.
26.0Kgws-sheets
Google Sheets: Read and write spreadsheets.
24.7Kgws-calendar
Google Calendar: Manage calendars and events.
24.6Kgws-docs-write
Google Docs: Append text to a document.
21.8K