Questa guida spiega come un amministratore Google Workspace collega la propria organizzazione ad Altamira, in modo che la piattaforma possa creare e gestire le riunioni Google Meet delle lezioni in Aula Virtuale con un account aziendale di servizio (modalità applicativa), senza che i singoli utenti debbano collegare il proprio account Google.

Se prima di procedere vuoi valutare implicazioni, alternative e aspetti di sicurezza di questa modalità, leggi l'articolo Integrazione Google Meet in Altamira — Modalità Applicativa.

Prerequisiti

• Un dominio Google Workspace con licenze che includono Calendar e Google Meet.
• Un accesso Super Admin alla Console di amministrazione Google.
• Un progetto su Google Cloud Console (consigliato dedicato a questa integrazione).
• L'abilitazione della modalità applicativa sulla tua azienda in Altamira: va richiesta al tuo referente Altamira.

1. Creare il progetto Google Cloud e abilitare le API

Accedi a https://console.cloud.google.com/

1. Crea un nuovo progetto (es. "Altamira Meet Integration").
2. Vai su API e servizi → Libreria e abilita tutte e tre le API seguenti:
   • Google Calendar API — creazione dell'evento e generazione del link Meet;
   • Google Meet API — configurazione della stanza della riunione;
   • Admin SDK API — identificazione dei partecipanti per il report presenze.

Se una di queste API non è abilitata, la creazione delle riunioni può funzionare solo parzialmente.

2. Creare un account di servizio (Service Account)

1. Vai su IAM e amministrazione → Account di servizio.
2. Clicca Crea account di servizio, inserisci un nome e un ID (es. altamira-meet-api).
3. Clicca Crea e continua: non è necessario assegnare ruoli IAM, perché i permessi arrivano dalla delega Workspace e non da IAM.
4. Seleziona l'account creato e vai su Chiavi → Aggiungi chiave → Crea nuova chiave → JSON e scarica il file.

Conserva il file JSON in modo sicuro: è la credenziale con cui Altamira si autentica alle API Google.

3. Abilitare la delega a livello di dominio

Nelle impostazioni dell'account di servizio abilita Enable Google Workspace Domain-wide Delegation e prendi nota del Client ID numerico che viene mostrato.

4. Autorizzare l'account di servizio nella Console di amministrazione

1. Vai su https://admin.google.com/ con un account Super Admin.
2. Apri Sicurezza → Controlli su accesso e dati → Controlli API → Gestione della delega a livello di dominio.
3. Clicca Aggiungi nuovo e inserisci il Client ID del punto precedente.
4. Negli OAuth Scopes incolla i quattro scope seguenti, separati da virgola:

https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/meetings.space.readonly,https://www.googleapis.com/auth/meetings.space.settings,https://www.googleapis.com/auth/admin.directory.user.readonly

A cosa servono:

Vanno autorizzati tutti e quattro: Altamira usa due credenziali distinte, una per Calendar e una per Meet e Directory, perché Google non consente di combinare lo scope Calendar con quelli Meet sotto delega di dominio.

Se non vuoi concedere lo scope della rubrica (admin.directory.user.readonly), puoi autorizzarne solo tre: le riunioni vengono create regolarmente, ma i partecipanti non vengono identificati tramite email.

5. Individuare l'utente organizzatore

Serve l'indirizzo email di un utente reale e attivo del Workspace — non un alias e non un gruppo — con licenza adeguata a Calendar e Meet. Sarà l'organizzatore di tutte le riunioni create da Altamira e il proprietario degli eventi sul proprio calendario.

Usa un utente dedicato con i privilegi minimi necessari, mai un account Super Admin.

6. Inserire i valori in Altamira

Nelle Preferenze azienda della piattaforma vanno valorizzati:

• il contenuto del file JSON dell'account di servizio, che Altamira conserva cifrato;
• l'email dell'utente organizzatore.

La modalità applicativa si attiva solo quando sono presenti entrambi i valori e la modalità è abilitata per la tua azienda.

7. Verificare il funzionamento

1. Crea una lezione in Aula Virtuale scegliendo Google Meet come provider, con docente, data e ora valorizzati.
2. Lancia l'azione di creazione delle riunioni online dall'edizione del corso.
3. Verifica che la lezione riporti il link Meet e che docente e iscritti abbiano ricevuto la mail con l'invito.
4. Controlla che l'evento sia presente sul calendario dell'utente organizzatore.

Cosa cambia per gli utenti

• I docenti e gli utenti che pianificano le lezioni non devono collegare il proprio account Google né accettare schermate di consenso.
• L'organizzatore di tutte le riunioni è l'account di servizio configurato, non il docente: per sapere chi può moderare la lezione e come promuovere il docente a co-organizzatore, leggi Ruoli e autorizzazioni nelle lezioni online (Aula Virtuale).
• Ogni riunione viene creata come aperta all'accesso esterno e con moderazione attiva, così che i partecipanti esterni al dominio possano entrare direttamente dal link: valuta se è compatibile con le policy della tua organizzazione.
• Con questa modalità attiva, Zoom non è più selezionabile come provider delle lezioni.

Per supporto tecnico o domande, contatta il team Altamira.