Skip to content
Studeia Docs

Google Meet integration (OAuth + Calendar API + Meet REST v2)

Google Meet integration in Studeia: OAuth 2.0 admin consent, Calendar API auto-generates Meet links, Meet REST API v2 for status. Recording/transcription requires manual host action

2026-05-24 5 min
Resposta curta

Google Meet integrates as video provider via OAuth 2.0 admin consent + Calendar API (creates event with Meet link) + Meet REST API v2 (status). Setup ~15min via Google Cloud Console. Limitations: recording/transcription started MANUALLY by host (Google doesn't expose start_recording API), endMeeting not supported (adapter marks as completed locally), full functionality requires paid Workspace.

Setup

1. Google Cloud Console

Enable Google Calendar API + Google Meet REST API v2. Credentials > OAuth 2.0 Client ID > Web application. Redirect URI: https://[tenant].studeia.com/api/institution/video-provider/callback/google-meet.

2. Studeia

Settings > Video Provider > Google Meet > Connect > paste Client ID + Secret > Authorize (admin consent flow). Tokens stored AES-256-GCM encrypted.

How it works

Studeia GoogleMeetAdapter.createMeeting() → Calendar API: events.insert with conferenceData.createRequest → Google returns event + hangoutLink. Student joins via joinMethod=external (new tab).

Recording sync

Cron /api/cron/recording-sync every 15min: queries Meet REST API v2 GET /v2/conferenceRecords/{name}. Updates recordingUrl + creates LiveClassTranscription if transcript available.

Recording must have been STARTED by host during meeting. If host forgot: no recording to sync.

Limitations vs Zoom/Teams

FeatureGoogle MeetZoomTeams
Create meeting via APIYesYesYes
End meeting via APINOYesNO
Start recording via APINOYesNO
Get recording via APIYesYesYes
Auto transcriptYes (Workspace Edu+)Yes (VTT)Yes (VTT)
Webhook lifecycleNO (polling only)YesYes (Graph Notifications)

When NOT to use Google Meet

  • ❌ School without paid Workspace (1h limit per meeting)
  • ❌ Want automatic recording without depending on host clicking
  • ❌ Want iframe embed (use BBB)
  • ❌ Want webhook meeting events

See also

FAQ

How does Studeia create meeting in Google Meet?

Via Google Calendar API. Studeia creates Calendar event with conferenceData requesting Meet link — Google auto-generates URL. Meet REST API v2 used for status and recordings queries.

Does Google Meet have automatic recording?

Only via Google Workspace Business Standard+ or Education Standard+. Even so, recording must be started MANUALLY by host in Meet (Google doesn't expose API for auto start_recording). Studeia queries recordings via Calendar Events API + Drive API after meeting ends.

Can I use Google Meet without paid Workspace?

To create meetings via API: requires paid Workspace. For students to JOIN: anyone can (including personal @gmail.com). For Workspace for Education Fundamentals (free): meetings work but with 1h limit per session.

Does endMeeting endpoint work?

NO. Google doesn't expose API to end meeting programmatically. Studeia adapter marks as completed locally (LiveClass.actualEndTime = now()) but the Google meeting itself continues until last participant leaves or host clicks 'End meeting' manually.

Veja tambem

Google Meet integration (OAuth + Calendar API + Meet REST v2)