Vai al contenuto principale
Invia email, sincronizza calendari e contatti e lavora con i file dalla tua app. Collega ogni servizio Google singolarmente, oppure usa il connettore Google Workspace per lavorare su più servizi con un’unica connessione.

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.
Cerchi un altro connettore Google? Consulta Google Maps, Google Search Console e altri nel catalogo dei connettori.

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.
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:
  1. Clicca su Connectors nella barra laterale del workspace.
  2. Clicca su Add connector.
  3. Cerca Google Workspace, o un singolo servizio come Google Calendar, e cliccaci sopra.
  4. Seleziona Shared connector, poi clicca su Next.
  5. Inserisci un Connection name.
  6. In Who can access, scegli dove si può usare la connessione: Apps and Super agent (l’impostazione predefinita), Apps only o Super agent only.
  7. 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.
  8. Clicca su Add connector, poi accedi con l’account Google che vuoi condividere.
  9. Apri la tua app nell’editor dell’app.
  10. 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 metadati
  • gmail.modify: legge, etichetta e modifica i messaggi, ma non li elimina definitivamente
  • gmail.compose: crea bozze e invia email
  • gmail.send: invia messaggi
  • gmail.labels: gestisce le etichette
  • gmail.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 calendar gestisce tutti i calendari. Scegli uno scope più ristretto se la tua app legge solo eventi o disponibilità.
I nomi degli scope di Google Calendar iniziano con https://www.googleapis.com/auth/:
  • calendar: gestisce tutti i calendari e gli eventi
  • calendar.readonly: visualizza tutti i calendari, gli eventi e le relative impostazioni
  • calendar.events: gestisce gli eventi dei calendari
  • calendar.events.readonly: visualizza gli eventi dei calendari
  • calendar.events.freebusy: visualizza le informazioni libero/occupato dei calendari senza vedere i dettagli degli eventi
  • calendar.freebusy: visualizza le informazioni libero/occupato dei calendari
  • calendar.app.created: gestisce i calendari creati dalla tua app
  • calendar.calendarlist.readonly: visualizza l’elenco dei calendari
  • calendar.events.public.readonly: visualizza gli eventi pubblici dei calendari
  • calendar.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 contacts.readonly se la tua app deve solo leggere i contatti salvati.
I nomi degli scope di Google Contacts iniziano con https://www.googleapis.com/auth/:
  • contacts.readonly: visualizza i contatti
  • contacts: visualizza, crea, modifica ed elimina i contatti
  • contacts.other.readonly: visualizza gli altri contatti, ad esempio persone a cui hai scritto ma che non hai salvato
  • directory.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 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.
I nomi degli scope di Google Drive iniziano con https://www.googleapis.com/auth/:
  • drive: visualizza, crea, modifica ed elimina tutti i file e le cartelle in Google Drive
  • drive.readonly: visualizza tutti i file e le cartelle in Google Drive
  • drive.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 documents permette alla tua app di visualizzare e modificare tutti i documenti Google Docs dell’account collegato, non solo quelli che crea.
I nomi degli scope di Google Docs iniziano con https://www.googleapis.com/auth/:
  • documents: visualizza, crea e modifica tutti i documenti Google Docs
  • documents.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 spreadsheets permette alla tua app di modificare tutti i fogli di calcolo dell’account, non solo quelli che crea.
I nomi degli scope di Google Sheets iniziano con https://www.googleapis.com/auth/:
  • spreadsheets: visualizza, modifica, crea ed elimina tutti i fogli di calcolo Google Sheets
  • spreadsheets.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.
Per inviare email senza la verifica degli scope restricted, richiedi solo gmail.send.
La verifica degli scope restricted può richiedere diverse settimane. Finché Google non approva la tua app, può limitare il numero di persone che possono collegarsi e mostrare un avviso di app non verificata. Se Google richiede una valutazione di sicurezza, un valutatore indipendente approvato da Google esamina la tua app con il framework CASA. La valutazione riguarda sia il tuo codice sia la piattaforma su cui gira la tua app. Consulta la documentazione per sviluppatori di Google per requisiti, tempi ed eccezioni aggiornati prima di pianificare il lancio.

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 a getConnection() un ID servizio dalla tabella qui sotto. Per una connessione per utenti dell’app, passa l’ID del tuo connettore, non un ID servizio.

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.
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.
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.