Google Workspace Gemini adoption

Google Workspace supplies per-user Gemini adoption and licensing context for workforce AI usage inside Workspace.

Release state

This guide documents the read-only google_workspace_gemini connector implemented in the platform connector surface.

Required access

Grant a service account or delegated admin integration these read-only scopes:

Scope	Purpose
https://www.googleapis.com/auth/admin.reports.audit.readonly	Read Gemini audit activity available through the Reports API.
https://www.googleapis.com/auth/admin.directory.user.readonly	Resolve report actors to directory users.

Google’s Enterprise License Manager API exposes only a read/write OAuth scope, so Venturi does not request it. If license context is required, provide a customer-generated license export through the approved onboarding channel. Do not grant user, license, or directory mutation permissions.

Setup

1. Create a dedicated Google Workspace integration identity.
2. Grant only the read-only scopes above.
3. Store the credential reference in Venturi.
4. Configure VENTURI_GOOGLE_WORKSPACE_CUSTOMER_ID and set VENTURI_GOOGLE_WORKSPACE_LOOKBACK_DAYS if you need a non-default window.
5. In Venturi, open Integrations and select Google Workspace Gemini and run Test connection.

Verification

• The connector inventory marks Google Workspace Gemini as read-only.

• Per-user adoption rows appear in the latest sync.

• License context appears only when supplied by an approved customer export.
• The connector preserves one normalized adoption record per user instead of collapsing everything to tenant totals.

Rotation and offboarding

Rotate delegated credentials through Google Workspace administration. Removing the connector stops new Gemini adoption syncs.