Collega il tuo account Google Calendar a Goodweek per leggere, creare e gestire eventi del calendario e programmi direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Google Calendar, garantendo l'allineamento con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che un utente possa vedere e collegare l'integrazione di Google Calendar, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
Account Google personali (@gmail.com)
Non è richiesta alcuna configurazione da parte dell'amministratore. Collegati direttamente seguendo i passaggi di Connessione utente riportati di seguito.
Account Google Workspace (lavoro o istituto scolastico)
A seconda della policy di accesso alle API della tua organizzazione, potrebbe applicarsi uno dei seguenti scenari.
Scenario 1 — Predefinito (accesso di terze parti senza restrizioni)
Qualsiasi utente può collegarsi direttamente senza l'intervento dell'amministratore.
Scenario 2 — L'accesso di terze parti è limitato (errore admin_policy_enforced)
Un Super Admin di Google Workspace deve contrassegnare Composio come app attendibile:
Accedi a admin.google.com come Super Admin.
Vai su Sicurezza → Controllo di accesso e dati → Controlli API → Gestisci l'accesso delle app di terze parti.
Fai clic su Configure new app, cerca Composio, selezionalo, imposta l'accesso su Trusted e fai clic su Save.
Scenario 3 — Tutto l'accesso di terze parti alle API è bloccato
Vai su admin.google.com → Sicurezza → Controllo di accesso e dati → Controlli API e controlla l'impostazione "Third-party app access to Google APIs". Se è bloccata, l'amministratore deve creare un'eccezione per Composio prima di seguire lo Scenario 2.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova Google Calendar e fai clic su Connect.
Verrai reindirizzato a Google, dove ti verrà chiesto di accedere.
Controlla le autorizzazioni richieste e fai clic su Allow per tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account singolarmente.
Goodweek può accedere solo ai calendari a cui il tuo account utente individuale ha accesso. I calendari condivisi sono accessibili solo se ti sono state concesse le autorizzazioni di condivisione appropriate.
Se hai più account Google, assicurati di selezionare quello corretto durante il passaggio di connessione.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da myaccount.google.com → Sicurezza → App di terze parti con accesso all'account.
Strumenti disponibili
Strumento | Descrizione | Tipo |
Create Event | Crea un nuovo evento in un Google Calendar con orario di inizio, durata, partecipanti e altri dettagli. | Scrittura |
Update Event | Aggiorna i campi di un evento del calendario esistente tramite il suo ID. | Scrittura |
Patch Event | Aggiorna parzialmente campi specifici di un evento del calendario esistente senza sovrascrivere il resto. | Scrittura |
Quick Add Event | Crea un evento di calendario di base analizzando una stringa di testo in linguaggio naturale (ad es. «Pranzo con Alice domani all'una»). | Scrittura |
Get Event | Recupera un singolo evento del calendario tramite il suo ID univoco. | Lettura |
Find Event | Cerca eventi in un calendario utilizzando una query di testo, intervalli di tempo e tipi di evento. | Lettura |
List Events | Restituisce gli eventi di un calendario specificato entro un determinato intervallo di tempo. | Lettura |
List Events from All Calendars | Restituisce un elenco unificato di eventi da tutti i calendari nell'elenco calendari dell'utente per un determinato intervallo di tempo. | Lettura |
Get Event Instances | Restituisce tutte le istanze di un evento ricorrente entro un intervallo di tempo facoltativo. | Lettura |
Find Free Slots | Trova le fasce orarie libere e occupate nei calendari specificati entro un intervallo di tempo definito. | Lettura |
Get Current Date and Time | Restituisce la data e l'ora correnti per un fuso orario specificato, utile prima di calcolare date relative. | Lettura |
Create a New Calendar | Crea un nuovo Google Calendar secondario con un titolo specificato e impostazioni facoltative. | Scrittura |
List Google Calendars | Recupera tutti i calendari dall'elenco Google Calendar dell'utente. | Lettura |
Patch Calendar | Aggiorna parzialmente i metadati di un calendario esistente (nome, descrizione, fuso orario, ecc.). | Scrittura |
Move Event | Sposta un evento in un calendario diverso. | Lettura |
List Calendar Resources | Recupera risorse del calendario, come sale riunioni, da un dominio Google Workspace. | Lettura |
Create ACL Rule | Crea una regola di controllo degli accessi per concedere autorizzazioni di condivisione del calendario a un utente, gruppo o dominio. | Scrittura |
List ACL Rules | Recupera tutte le regole di controllo degli accessi per un calendario specificato. | Lettura |
Delete Event | Elimina definitivamente un evento del calendario specificato tramite il suo ID. | ⚠️ Destruttivo |
Remove Attendee from Event | Rimuove un partecipante specifico da un evento del calendario esistente. | ⚠️ Destruttivo |
Delete Calendar | Elimina definitivamente un calendario secondario di proprietà dell'utente. | ⚠️ Destruttivo |
Clear Calendar | Elimina tutti gli eventi da un calendario principale mantenendo il calendario stesso. | ⚠️ Destruttivo |
Delete ACL Rule | Rimuove un'autorizzazione di condivisione da un Google Calendar. | ⚠️ Destruttivo |
Casi d'uso
Crea e gestisci eventi dalle conversazioni. Pianifica riunioni, imposta promemoria o aggiungi eventi al tuo Google Calendar direttamente da una conversazione di Goodweek, inclusi partecipanti, luogo e descrizione, senza passare all'app calendario.
Controlla la disponibilità prima di pianificare. Interroga le fasce libere e occupate di uno o più calendari per trovare un orario di riunione adatto prima di proporlo ai partecipanti.
Consulta la tua agenda quando vuoi. Recupera gli eventi di oggi, di questa settimana o di qualsiasi intervallo di tempo personalizzato su tutti i tuoi calendari per avere una rapida panoramica del tuo programma senza uscire dal tuo spazio di lavoro.
Aggiorna o annulla eventi rapidamente. Modifica i dettagli di un evento o rimuovi partecipanti da riunioni esistenti direttamente da Goodweek quando i piani cambiano, senza dover navigare nell'interfaccia del calendario.
Risoluzione dei problemi
"Error 400: admin_policy_enforced" durante la connessione
L'amministratore della tua organizzazione ha limitato l'accesso delle app di terze parti. Solo un Super Admin di Google Workspace può risolvere questo problema seguendo lo Scenario 2 sopra.
L'amministratore ha contrassegnato Composio come Trusted ma l'errore continua a comparire
Potrebbe esserci un ritardo di propagazione. Attendi qualche minuto e riprova.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione di Google Calendar dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.