Skip to main content

Google Workspace integration

Google Workspace is Google's suite of cloud collaboration tools. The gworkspace resource type provides OAuth access to the Google Admin Directory API for managing users, groups, org units, and security settings.

The Google Workspace integration is done through OAuth. You just need to sign in from your Google account on your browser. The access will be automatically saved to the workspace as a resource.

The default OAuth scopes are:

  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.security
  • https://www.googleapis.com/auth/admin.directory.orgunit

On self-hosted instances, integrating an OAuth API will require Setup OAuth and SSO.

Your resource can be used passed as parameters or directly fetched within scripts, flows and apps.


Example of a Supabase resource being used in two different manners from a script in Windmill.


Native triggers

The gworkspace resource type is also used by Google native triggers to watch for changes in Google Drive and Google Calendar. When configured through the native triggers workspace integration, the resource is created with different scopes (drive.readonly, calendar.readonly, calendar.events) tailored to receiving push notifications.

tip

Find some pre-set interactions with Google Workspace on the Hub.

Feel free to create your own Google Workspace scripts on Windmill.