gws-events

Subscribe to Google Workspace events and manage event subscriptions via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-events-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-events
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-events
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-events-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Workspace event subscriptions manually through API calls is tedious and error-prone. This Skill lets you create, renew, reactivate, and stream Workspace event subscriptions directly through the gws CLI. ## Core Features & Use Cases - Subscription Management: Create, list, get, update, delete, and reactivate Google Workspace subscriptions using the Workspace Events API. - Event Streaming: Subscribe to Workspace events and stream them as NDJSON, or attach streams to in-process tasks for real-time updates. - Operation Polling: Check the state of long-running operations and cancel or monitor tasks from the agent. - Use Case: Set up a subscription to watch a Google Drive folder for changes, stream the resulting events as NDJSON, and renew the subscription automatically before it expires. ## Quick Start Ask the AI to subscribe to Google Workspace events for a specific resource and stream the results using the gws events commands.

Frequently Asked Questions about gws-events

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I subscribe to Google Workspace events from the command line?

Use the gws events subscriptions create method with the appropriate target resource and event types, or use the +subscribe helper to stream events as NDJSON. Inspect required parameters first with gws schema events.subscriptions.create.

How do I renew an expiring Google Workspace subscription?

Use the +renew helper command or call gws events subscriptions patch to update or renew the subscription before it expires. The Workspace Events API documentation covers renewal requirements.

What do I need before using gws events commands?

You need the gws binary installed and authentication configured as described in the gws-shared skill. If that shared skill is missing, run gws generate-skills to create it before using any events commands.

Why is my Google Workspace subscription suspended and how do I fix it?

Subscriptions enter a suspended state when an error occurs, such as notification endpoint failures. Fix the underlying error first, then call gws events subscriptions reactivate to reset the state to ACTIVE.

Can I stream task updates from a running agent task?

Yes, use gws events tasks subscribe to attach a stream to an existing in-process task and receive task update events. If the task is already complete, the stream returns the completed task and closes.