Google AppBuilder Components

This directory contains a suite of Google Workspace integration components for the ValRM AppBuilder. These components enable users to search, manage, and synchronize various Google Workspace resources such as Users, Groups, Shared Drives, Gmail, and Calendar.

Core Management Components

Google Management (Management/)

A dashboard-style component that provides a unified interface for several Google management tools. It includes UserSearch, GroupSearch, SharedDriveSearch, RoleSearch, PubSubManager, and GmailWatchControl.

Pub/Sub Manager (PubSubManager/)

Allows administrators to create and delete Google Cloud Pub/Sub subscriptions for automated event processing (e.g., Gmail notifications). It features a modern management UI with input for the subscription path and real-time feedback.

---

Search Components

These components provide specialized search interfaces for Google Workspace resources.

User Search (UserSearch/)

Allows searching for users within the Google Workspace organization.

Group Search (GroupSearch/)

Allows searching for Google Groups.

Role Search (RoleSearch/)

Allows searching for organization roles.

Shared Drive Search (SharedDriveSearch/)

Allows searching for Google Shared Drives.

---

Gmail Control & Sync

Gmail Sync (GmailSync/)

Initiates a full, asynchronous Gmail synchronization for the current user. This process fetches historical emails and ensures the local database is up-to-date. The UI follows the modern management pattern.

Gmail Watch Control (GmailWatchControl/)

Provides components to start and stop a "Watch" on a user's Gmail inbox.

• Gmail Watch Start: Sets up a push notification channel to receive real-time updates for new emails.
• Gmail Watch Stop: Terminates the active watch channel.

---

Calendar Control & Sync

Calendar Sync (CalendarSync/)

Initiates an asynchronous synchronization of Google Calendar events.

• Configuration: Supports specifying multiple calendar IDs (comma-separated), and a time range (time_min and time_max in ISO format).
• UI: Features a clean management card with input fields and real-time status messages.

Calendar Watch Control (CalendarWatchControl/)

Provides components to manage push notifications for specific Google Calendars.

• Calendar Watch Start: Starts watching a specific calendar_id (defaulting to "primary").
• Calendar Watch Stop: Stops an active watch channel. Requires both the calendar_id and the resource_id of the channel to be terminated.

---

Drive Control

Drive Watch Control (DriveWatchControl/)

Enables push notification management for specific Google Drive files or folders.

• Drive Watch Start: Starts watching a specific file_id or folder ID for changes.
• Drive Watch Stop: Stops an active watch channel for a specific file_id. Requires the resource_id of the channel.