Cosa puoi fare
Scegli un servizio Google per vedere cosa puoi costruire, oppure usa il connettore Google Workspace per combinarne diversi in un’unica connessione.Gmail
Invia, leggi e organizza le email.
Google Calendar
Sincronizza gli eventi e mostra la tua disponibilità.
Google Contacts
Trova, aggiungi e aggiorna i contatti.
Google Drive
Salva, condividi e organizza i file.
Google Docs
Genera e aggiorna documenti.
Google Sheets
Leggi, scrivi e aggiorna fogli di calcolo.
Gmail
Prompt di esempio Descrivi nella chat AI oggetto, corpo del messaggio, formattazione, destinatari ed eventuali campi dinamici. Ad esempio:Google Calendar
Prompt di esempio Descrivi nella chat AI il calendario, gli eventi, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:Google Contacts
Prompt di esempio Descrivi nella chat AI i contatti, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:Google Drive
Prompt di esempio Descrivi nella chat AI i file o le cartelle, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:Google Docs
Prompt di esempio Descrivi nella chat AI il documento, cosa lo avvia ed eventuali campi dinamici. Ad esempio:Google Sheets
Prompt di esempio Descrivi nella chat AI il foglio di calcolo, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:Connettore Google Workspace
Crea funzionalità che lavorano su posta, calendario, contatti e file, come un assistente che prepara le riunioni usando le email e i documenti correlati. Prompt di esempio Descrivi nella chat AI i servizi Google coinvolti, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:Connettere un servizio Google
Collega un servizio Google tramite un account condiviso o lascia che ogni persona colleghi il proprio.- Connettore condiviso
- Connettore per utenti dell'app
Colleghi un account una sola volta e tutti quelli che usano la tua app condividono quella connessione e i suoi dati.Per aggiungere un connettore Google condiviso:
- Clicca su Connectors nella barra laterale del workspace.
- Clicca su Add connector.
- Cerca Google Workspace, o un singolo servizio come Google Calendar, e cliccaci sopra.
- Seleziona Shared connector, poi clicca su Next.
- Inserisci un Connection name.
- In Who can access, scegli dove si può usare la connessione: Apps and Super agent (l’impostazione predefinita), Apps only o Super agent only.
- Sotto Permissions, scegli l’accesso di cui la tua app ha bisogno:
- Read-only: la tua app può visualizzare i dati. È l’impostazione predefinita.
- Read & write: la tua app può inviare, creare o modificare i dati.
- Custom: seleziona i permessi facoltativi di cui la tua app ha bisogno. I permessi obbligatori restano selezionati.
- Clicca su Add connector, poi accedi con l’account Google che vuoi condividere.
- Apri la tua app nell’editor dell’app.
- Chiedi alla chat AI di usare la connessione Google condivisa per la funzionalità che vuoi costruire.
Scope e permessi
Gli scope determinano a cosa la tua app può accedere o cosa può modificare in Google. Usa le card dei servizi qui sotto per scegliere solo i permessi di cui la tua app ha bisogno.Scope
email obbligatorioBase44 richiede sempre lo scope email per identificare l’account Google collegato. Questo permesso obbligatorio resta selezionato:- Shared connector: sotto Permissions, quando scegli Custom.
- App user connector: sotto Scopes.
Gmail
La lettura del contenuto della posta è uno scope Google restricted.
I nomi degli scope Gmail iniziano con https://www.googleapis.com/auth/:gmail.readonly: legge messaggi e metadatigmail.modify: legge, etichetta e modifica i messaggi, ma non li elimina definitivamentegmail.compose: crea bozze e invia emailgmail.send: invia messaggigmail.labels: gestisce le etichettegmail.settings.basic: gestisce filtri, firme e risposta automatica
Accesso: la tua app lavora con la posta dell’account Gmail che autorizza la connessione.
Google Calendar
Lo scope ampio
I nomi degli scope di Google Calendar iniziano con calendar gestisce tutti i calendari. Scegli uno scope più ristretto se la tua app legge solo eventi o disponibilità.https://www.googleapis.com/auth/:calendar: gestisce tutti i calendari e gli eventicalendar.readonly: visualizza tutti i calendari, gli eventi e le relative impostazionicalendar.events: gestisce gli eventi dei calendaricalendar.events.readonly: visualizza gli eventi dei calendaricalendar.events.freebusy: visualizza le informazioni libero/occupato dei calendari senza vedere i dettagli degli eventicalendar.freebusy: visualizza le informazioni libero/occupato dei calendaricalendar.app.created: gestisce i calendari creati dalla tua appcalendar.calendarlist.readonly: visualizza l’elenco dei calendaricalendar.events.public.readonly: visualizza gli eventi pubblici dei calendaricalendar.settings.readonly: visualizza le impostazioni di Google Calendar
Accesso: la tua app lavora con i calendari dell’account Google che autorizza la connessione.
Google Contacts
Scegli
I nomi degli scope di Google Contacts iniziano con contacts.readonly se la tua app deve solo leggere i contatti salvati.https://www.googleapis.com/auth/:contacts.readonly: visualizza i contatticontacts: visualizza, crea, modifica ed elimina i contatticontacts.other.readonly: visualizza gli altri contatti, ad esempio persone a cui hai scritto ma che non hai salvatodirectory.readonly: visualizza la directory Google Workspace della tua organizzazione
Accesso: la tua app lavora con i contatti dell’account Google che autorizza la connessione.
Google Drive
Lo scope
I nomi degli scope di Google Drive iniziano con drive dà alla tua app accesso a tutti i file e le cartelle in Google Drive. Lo scope drive.file copre solo i file che la tua app crea o apre.https://www.googleapis.com/auth/:drive: visualizza, crea, modifica ed elimina tutti i file e le cartelle in Google Drivedrive.readonly: visualizza tutti i file e le cartelle in Google Drivedrive.file: accede solo ai file che la tua app crea o apre con autorizzazione
Accesso: la tua app lavora con i file nel Google Drive dell’account Google che autorizza la connessione.
Google Docs
Lo scope
I nomi degli scope di Google Docs iniziano con documents permette alla tua app di visualizzare e modificare tutti i documenti Google Docs dell’account collegato, non solo quelli che crea.https://www.googleapis.com/auth/:documents: visualizza, crea e modifica tutti i documenti Google Docsdocuments.readonly: visualizza tutti i documenti Google Docs
Accesso: la tua app lavora con i documenti dell’account Google che autorizza la connessione.
Google Sheets
Lo scope
I nomi degli scope di Google Sheets iniziano con spreadsheets permette alla tua app di modificare tutti i fogli di calcolo dell’account, non solo quelli che crea.https://www.googleapis.com/auth/:spreadsheets: visualizza, modifica, crea ed elimina tutti i fogli di calcolo Google Sheetsspreadsheets.readonly: visualizza tutti i fogli di calcolo Google Sheets
Accesso: la tua app lavora con i fogli di calcolo dell’account Google che autorizza la connessione.
Google Workspace
Questo connettore richiede gli scope qui sotto su 6 servizi. Quindi gli serve più accesso rispetto a un connettore singolo.
- Gmail:
gmail.readonly,gmail.modify,gmail.compose,gmail.send - Calendar:
calendar.readonly,calendar.settings.readonly,calendar.events - Contacts:
contacts.readonly - Drive:
drive.readonly,drive - Docs:
documents.readonly,documents - Sheets:
spreadsheets.readonly,spreadsheets
Le card dei servizi qui sopra spiegano cosa consentono questi scope.
Accesso: la tua app lavora con i dati dell’account Google che autorizza la connessione.
Verifica con il tuo client OAuth
Quando usi il tuo client OAuth, l’app OAuth è tua e sei tu a inviarne la verifica a Google. I connettori Google condivisi e Let Base44 manage OAuth usano l’app OAuth di Base44. In questi casi non devi inviare nulla a Google. Consulta Usare il tuo client OAuth. Google raggruppa le autorizzazioni richieste dalla tua app in 3 categorie. Questi gruppi determinano la verifica necessaria prima che la tua app vada live. Quindi scegli gli scope più ristretti che supportano ciò che fa la tua app. Questo conta soprattutto per Gmail, Drive e Calendar.- Basic: copre nome, indirizzo email e profilo. Google non chiede nulla in più.
- Sensitive: copre un accesso più ampio a un servizio Google, ad esempio la creazione di eventi del calendario. Google chiede la verifica dell’app, inclusa una revisione di come usi i dati.
- Restricted: copre la lettura del contenuto di messaggi o file di una persona, ad esempio la lettura di Gmail. Google chiede la verifica dell’app e può richiedere anche una valutazione di sicurezza indipendente annuale.
Usare i servizi Google in una funzione backend
Se scrivi le tue funzioni backend, possono chiamare direttamente le API di Google. Base44 gestisce il flusso OAuth e l’archiviazione dei token. Per una connessione condivisa, passa agetConnection() un ID servizio dalla tabella qui sotto. Per una connessione per utenti dell’app, passa l’ID del tuo connettore, non un ID servizio.
- Connettore condiviso
- Connettore per utenti dell'app
Connettori condivisi
Configura, distribuisci e chiama una connessione condivisa da una funzione backend.
Connettori per utenti dell'app
Recupera un token per singolo utente e chiama l’API come la persona che ha effettuato l’accesso.
Risoluzione dei problemi
Se usi il tuo client OAuth, controlla questi punti quando le persone non riescono a collegare il proprio account Google.Alcune persone non riescono a collegare il proprio account
Alcune persone non riescono a collegare il proprio account
Se usi il tuo client OAuth, parte in modalità di test. In questa modalità possono collegarsi solo gli utenti di test approvati. Prima di aprire l’accesso a più persone, porta la tua app OAuth in produzione e completa le verifiche richieste da Google.
La connessione non riesce con un errore di redirect URI
La connessione non riesce con un errore di redirect URI
Registra l’URL di callback usato dalla tua connessione come redirect URI autorizzato nel tuo client OAuth Google:
- Per l’URL di callback unico, inserisci esattamente
https://connectors.base44.com/api/oauth/callback. - Per gli URL di callback per singola app, consulta Usare il tuo client OAuth.
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.