Google Gemini for Workspace connector

Connect Claresia to Google Gemini for Workspace. End users invoke skills as Gemini Gems inside Google Workspace (Docs, Sheets, Gmail, Meet, Chat).

Prerequisites

Google Workspace Enterprise Plus with Gemini for Workspace add-on
A Workspace super admin to grant the OAuth scopes
Zero-retention configured for Workspace AI

Part 1 — Connect in Claresia

In Claresia Onboarding Portal, click Connect LLM (Step 6) → pick Google Gemini for Workspace.
Click Sign in with Google Workspace — opens Google’s OAuth consent. Sign in as super admin and grant:
- admin.directory.user.readonly
- admin.directory.group.readonly
- admin.reports.audit.readonly
- gemini.workspace.gems.write (when GA)
Click Test connection — Claresia calls Workspace Admin API to confirm.

Part 2 — Skill publish — manual fallback (today)

Until the Gems publish API is GA:

Command Center → Distribution → Google Gemini → Export
Download per-skill Gem JSON bundle + a CSV manifest
Upload via Workspace Admin → Apps → Google Workspace → Gemini → Custom Gems → Bulk import
Set group ACLs to match your Workspace groups (Google Groups created earlier)

Part 3 — Skill publish — automated path (when Gems API is GA)

Claresia transpiles each Skill IR into a Gemini Gem JSON
POSTs to Workspace Admin Gems API: POST https://admin.googleapis.com/admin/directory/v1/customer/{customer_id}/gemini/gems
Sets Gem ACL to match your Google Group → archetype mapping
End users see the Gem in their Workspace AI sidebar within ~2 min

Part 4 — Telemetry ingest

Claresia polls the Workspace Admin Audit API every 60s for events in the gemini activity:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/gemini
  ?filters=event_name=gem_invocation
  &startTime=<last_seen_ts>

For events tagged claresia-*, we normalize to fn_telemetry_event.

End-user experience inside Workspace

User opens Gmail → clicks Gemini sidebar → types:

@claresia-pipeline-hygiene

Or in Docs / Sheets, the Gem is invoked via the Gemini panel. Reply is rendered inline with the standard Claresia footer:

[skill output body]

Claresia · Pipeline Hygiene · $0.04 · 2.3s · View record

Hub emission

Gemini Gems support function calling via the Gemini Tools API. Claresia injects a claresia.emit_hub_record tool into every Gem definition. Function body is hosted at the Hub ingest endpoint per deployment mode.

Common gotchas

Symptom	Cause	Fix
Gems don’t appear	Gems publish API not yet GA	Use the manual export / bulk-import flow
Telemetry missing	Audit API delay (Workspace lags up to 1h for some events)	Expected — we surface within 60 min worst-case
Hub records missing	Function calling not enabled in Gem	Re-export from Claresia (sets the tool list correctly)
`403` on connect	Super admin scope missing	Re-grant with all 4 scopes listed above