Connettori Google Workspace

Scegli un connettore e collegalo tramite un account condiviso o l’account personale di ogni persona. Gli scope sono le autorizzazioni che la tua app richiede a Google. Richiedi solo quelli che le servono.

Ti serve un piano Builder o superiore per usare i connettori nella tua app.

Cosa puoi fare

Collega la tua app a email, calendari, contatti e file.

Automatizza le email

Invia conferme e follow-up, e trasforma le email in arrivo in attività o ticket.

Sincronizza calendari e contatti

Sincronizza le prenotazioni, mostra la tua disponibilità e tieni aggiornati i contatti.

Lavora con file e dati

Salva report su Drive, genera documenti Docs e importa o esporta dati di Sheets.

Connettore Google Workspace

Usa questo connettore quando la tua app combina diversi servizi Google. Ad esempio, un assistente che lavora con posta, calendario e file di Drive. Se ne usa solo uno o due, collega invece quelli. Prompt di esempio Descrivi nella chat AI i servizi Google coinvolti, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:

Conoscimi: scorri le mie email, riunioni e file di Drive e dimmi su cosa sto lavorando.

Fai da mio assistente personale: controlla posta e calendario e dimmi cosa richiede la mia attenzione oggi.

Prepara la mia prossima riunione usando thread email correlati, file e i dettagli dei partecipanti.

Prepara bozze di follow-up per i partecipanti dopo ogni riunione.

Trasforma le riunioni e le email di questa settimana in un documento Docs e un foglio Sheets.

Scope

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

Ogni scope è descritto sotto il relativo servizio in Servizi Google.

Accesso: la tua app lavora con i dati dell’account Google che autorizza la connessione.

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 il servizio che vuoi, ad esempio Google Calendar o Google Workspace, e cliccaci sopra.
Seleziona Shared connector, poi clicca su Next.
Inserisci un Connection name.
Sotto Who can access, scegli dove si può usare la connessione. L’impostazione predefinita è Apps and Super agent.
Se compare Permissions, scegli Read-only per visualizzare i dati, oppure Read & write se la tua app deve inviarli, crearli o modificarli. L’impostazione predefinita è Read-only.
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.

Ogni persona collega il proprio account Google, così la tua app lavora con i suoi dati. Google Calendar offre anche Let Base44 manage OAuth.

Prima di iniziare: i connettori per utenti dell’app li configurano proprietari e admin del workspace. Per usare Let Base44 manage OAuth ti serve un piano Pro o superiore. Se usi il tuo client OAuth, leggi Scope e autorizzazioni prima di costruire.

Se usi Let Base44 manage OAuth per Google Calendar, passa a Per aggiungere un connettore Google per utenti dell’app.Per preparare il tuo client OAuth:

Crea o seleziona un progetto nella console Google Cloud.
Abilita l’API per ogni servizio Google usato dalla tua app.
Configura la schermata di consenso OAuth con gli scope che intendi richiedere.
Mentre la tua app OAuth è in modalità di test, aggiungi come utenti di test gli account Google che userai per i test.
Crea un client OAuth per un’applicazione web.
Aggiungi https://connectors.base44.com/api/oauth/callback come redirect URI autorizzato.
Copia il client ID e il client secret.

Per aggiungere un connettore Google per utenti dell’app:

Clicca su Connectors nella barra laterale del workspace.
Clicca su Add connector.
Cerca il servizio che vuoi, ad esempio Google Calendar o Google Drive, e cliccaci sopra.
Seleziona App user connector, poi clicca su Next.
Se compare Choose how to manage authentication, seleziona Let Base44 manage OAuth o Use your own OAuth client.
Inserisci un Connector name.
Se usi il tuo client OAuth, inserisci il suo Client ID e Client Secret.
Sotto Scopes, deseleziona gli scope che non servono alla tua app. Con il tuo client OAuth, aggiungine altri sotto Additional scopes. Per sapere cosa fa ogni scope, consulta Servizi Google.
Clicca su Add Connector.
Apri la tua app nell’editor dell’app.
Chiedi alla chat AI di aggiungere un modo per far collegare a ogni persona il proprio account Google.

Servizi Google

Trova il servizio usato dalla tua app per vedere cosa può fare e quali scope richiede. Per altri connettori Google, come Google Analytics, Google Meet e Google Search Console, consulta il catalogo dei connettori.

Gmail

Invia, leggi e gestisci le email in Gmail. Prompt di esempio Descrivi nella chat AI oggetto, corpo del messaggio, formattazione, destinatari ed eventuali campi dinamici. Ad esempio:

Invia email di conferma automatiche quando viene effettuato un nuovo ordine.

Leggi e analizza le email in arrivo per creare ticket di supporto.

Avvia automaticamente un flusso quando arriva una nuova email.

Invia email di follow-up personalizzate ai nuovi lead.

Avvisa via email i membri del team quando vengono assegnate delle attività.

Scope

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

Accedi agli eventi di Google Calendar e gestiscili. Prompt di esempio Descrivi nella chat AI il calendario, gli eventi, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:

Sincronizza tutte le mie prenotazioni direttamente con il mio Google Calendar.

Mostra ai clienti la mia disponibilità in tempo reale da Google Calendar.

Esegui un'automazione quando un evento del calendario viene creato o aggiornato.

Blocca automaticamente gli orari delle riunioni nel mio calendario personale.

Aggiungi nuovi eventi al calendario quando un'attività viene segnata come completata.

Scope

Lo scope ampio calendar gestisce tutti i calendari. Scegli uno scope più ristretto se la tua app legge solo eventi o disponibilità. Con Let Base44 manage OAuth, il selettore offre solo gli scope più ristretti.

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

Leggi, crea e gestisci i contatti in Google Contacts. Prompt di esempio Descrivi nella chat AI i contatti, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:

Crea un CRM che sincronizza i clienti in entrambe le direzioni con i miei Google Contacts.

Importa come lead le persone a cui ho scritto ma che non ho mai salvato come contatti.

Analizza la mia rete di contatti e classifica automaticamente i contatti con l'AI.

Crea una directory aziendale ricercabile dalla mia organizzazione Google Workspace.

Salva automaticamente i nuovi clienti come contatti quando si registrano.

Scope

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

Cerca, apri e gestisci i file in Google Drive. Prompt di esempio Descrivi nella chat AI i file o le cartelle, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:

Elenca tutti i file nel mio Google Drive e mostrali nella mia app.

Cerca in Google Drive i documenti che corrispondono a una parola chiave e mostra i risultati.

Salva su Google Drive i report PDF generati dalla mia app.

Leggi un foglio di calcolo da Google Drive e importa i suoi dati nella mia app.

Avvia un flusso quando un file viene aggiunto o aggiornato in Drive.

Scope

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

Crea e modifica documenti Google Docs. Prompt di esempio Descrivi nella chat AI il documento, cosa lo avvia ed eventuali campi dinamici. Ad esempio:

Genera automaticamente documenti con le note delle riunioni.

Crea contratti da modelli con i dati dei clienti.

Aggiorna i documenti condivisi quando cambia lo stato del progetto.

Esporta i report in formato Google Docs.

Collabora sui documenti con i commenti del team.

Scope

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

Leggi e scrivi dati nei fogli di calcolo Google Sheets. Prompt di esempio Descrivi nella chat AI il foglio di calcolo, cosa avvia l’azione ed eventuali campi dinamici. Ad esempio:

Esporta i dati dell'app in un foglio di calcolo Google Sheets.

Importa i lead da un foglio Google Sheets nel CRM.

Aggiorna automaticamente le quantità di magazzino in Google Sheets.

Crea report settimanali e salvali in Google Sheets.

Sincronizza gli invii dei moduli con un database Google Sheets.

Scope

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.

Scope e autorizzazioni

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é non è completata, Google può limitare il numero di persone che possono usare la tua app 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 la piattaforma su cui gira la tua app sia il tuo codice. Quindi contatta il supporto per tempo. Requisiti, tempi ed eccezioni li decide Google, quindi consulta la documentazione per sviluppatori di Google prima di pianificare.

Base44 aggiunge sempre lo scope email per identificare l’account Google. Poiché è sempre incluso, appare come scope bloccato sotto Scopes.

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.

Connettore condiviso
Connettore per utenti dell'app

// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.

// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.

Servizio	ID servizio (connessioni condivise)
Gmail	`gmail`
Google Calendar	`googlecalendar`
Google Contacts	`google_contacts`
Google Drive	`googledrive`
Google Docs	`googledocs`
Google Sheets	`googlesheets`
Google Workspace	`googleworkspace`

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

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

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 Visualizzare i tuoi URL di callback.

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.

Per iniziare

Creare la tua app

Proteggere la tua app

Promuovere la tua app

Connettori

Registro modifiche

Cosa puoi fare

Automatizza le email

Sincronizza calendari e contatti

Lavora con file e dati

Connettore Google Workspace

Connettere un servizio Google

Servizi Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scope e autorizzazioni

Usare i servizi Google in una funzione backend

Connettori condivisi

Connettori per utenti dell'app

Risoluzione dei problemi

​Cosa puoi fare

Automatizza le email

Sincronizza calendari e contatti

Lavora con file e dati

​Connettore Google Workspace

​Connettere un servizio Google

​Servizi Google

​Gmail

​Google Calendar

​Google Contacts

​Google Drive

​Google Docs

​Google Sheets

​Scope e autorizzazioni

​Usare i servizi Google in una funzione backend

Connettori condivisi

Connettori per utenti dell'app

​Risoluzione dei problemi

Cosa puoi fare

Connettore Google Workspace

Connettere un servizio Google

Servizi Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

Scope e autorizzazioni

Usare i servizi Google in una funzione backend

Risoluzione dei problemi