Skip to content

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
admin.reports.usage.readonly Read per-user Gemini adoption rows.
admin.directory.user.readonly Read user context for attribution.
apps.licensing.readonly Read licensing context.

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 ARGMIN_GOOGLE_WORKSPACE_CUSTOMER_ID and set ARGMIN_GOOGLE_WORKSPACE_LOOKBACK_DAYS if you need a non-default window.
  5. In Venturi, open Administration -> Connectors -> Google Workspace Gemini and run Test connection.

Verification

  • Per-user adoption rows appear in the latest sync.
  • License context is visible where Workspace exposes it.
  • 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.