> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Connettori Google Workspace > Collega Gmail, Google Calendar, Contacts, Drive, Docs e Sheets con un connettore singolo, oppure lavora su tutti tramite il connettore 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. > [!NOTE] > > Ti serve un [**piano Builder**](https://base44.com/pricing) 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: ```text wrap theme={null} Conoscimi: scorri le mie email, riunioni e file di Drive e dimmi su cosa sto lavorando. ``` ```text wrap theme={null} Fai da mio assistente personale: controlla posta e calendario e dimmi cosa richiede la mia attenzione oggi. ``` ```text wrap theme={null} Prepara la mia prossima riunione usando thread email correlati, file e i dettagli dei partecipanti. ``` ```text wrap theme={null} Prepara bozze di follow-up per i partecipanti dopo ogni riunione. ``` ```text wrap theme={null} 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](#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** 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 il servizio che vuoi, ad esempio **Google Calendar** o **Google Workspace**, e cliccaci sopra. 4. Seleziona **Shared connector**, poi clicca su **Next**. 5. Inserisci un **Connection name**. 6. Sotto **Who can access**, scegli dove si può usare la connessione. L'impostazione predefinita è **Apps and Super agent**. 7. 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**. 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. **Connettore per utenti dell'app** Ogni persona collega il proprio account Google, così la tua app lavora con i suoi dati. Google Calendar offre anche **Let Base44 manage OAuth**. > [!TIP] > > **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](https://base44.com/pricing) o superiore. Se usi il tuo client OAuth, leggi [Scope e autorizzazioni](#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:** 1. Crea o seleziona un progetto nella console Google Cloud. 2. Abilita l'API per ogni servizio Google usato dalla tua app. 3. Configura la schermata di consenso OAuth con gli scope che intendi richiedere. 4. Mentre la tua app OAuth è in modalità di test, aggiungi come utenti di test gli account Google che userai per i test. 5. Crea un client OAuth per un'applicazione web. 6. Aggiungi `https://connectors.base44.com/api/oauth/callback` come redirect URI autorizzato. 7. Copia il client ID e il client secret. **Per aggiungere un connettore Google per utenti dell'app:** 1. Clicca su **Connectors** nella barra laterale del workspace. 2. Clicca su **Add connector**. 3. Cerca il servizio che vuoi, ad esempio **Google Calendar** o **Google Drive**, e cliccaci sopra. 4. Seleziona **App user connector**, poi clicca su **Next**. 5. Se compare **Choose how to manage authentication**, seleziona **Let Base44 manage OAuth** o **Use your own OAuth client**. 6. Inserisci un **Connector name**. 7. Se usi il tuo client OAuth, inserisci il suo **Client ID** e **Client Secret**. 8. 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](#servizi-google). 9. Clicca su **Add Connector**. 10. Apri la tua app nell'editor dell'app. 11. 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](https://docs.base44.com/it/Integrations/connectors-catalog.md). ### Gmail Invia, leggi e gestisci le email in [Gmail](https://base44.com/integrations/connectors/gmail). **Prompt di esempio** Descrivi nella chat AI oggetto, corpo del messaggio, formattazione, destinatari ed eventuali campi dinamici. Ad esempio: ```text wrap theme={null} Invia email di conferma automatiche quando viene effettuato un nuovo ordine. ``` ```text wrap theme={null} Leggi e analizza le email in arrivo per creare ticket di supporto. ``` ```text wrap theme={null} Avvia automaticamente un flusso quando arriva una nuova email. ``` ```text wrap theme={null} Invia email di follow-up personalizzate ai nuovi lead. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/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: ```text wrap theme={null} Sincronizza tutte le mie prenotazioni direttamente con il mio Google Calendar. ``` ```text wrap theme={null} Mostra ai clienti la mia disponibilità in tempo reale da Google Calendar. ``` ```text wrap theme={null} Esegui un'automazione quando un evento del calendario viene creato o aggiornato. ``` ```text wrap theme={null} Blocca automaticamente gli orari delle riunioni nel mio calendario personale. ``` ```text wrap theme={null} 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: ```text wrap theme={null} Crea un CRM che sincronizza i clienti in entrambe le direzioni con i miei Google Contacts. ``` ```text wrap theme={null} Importa come lead le persone a cui ho scritto ma che non ho mai salvato come contatti. ``` ```text wrap theme={null} Analizza la mia rete di contatti e classifica automaticamente i contatti con l'AI. ``` ```text wrap theme={null} Crea una directory aziendale ricercabile dalla mia organizzazione Google Workspace. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/google-drive). **Prompt di esempio** Descrivi nella chat AI i file o le cartelle, cosa avvia l'azione ed eventuali campi dinamici. Ad esempio: ```text wrap theme={null} Elenca tutti i file nel mio Google Drive e mostrali nella mia app. ``` ```text wrap theme={null} Cerca in Google Drive i documenti che corrispondono a una parola chiave e mostra i risultati. ``` ```text wrap theme={null} Salva su Google Drive i report PDF generati dalla mia app. ``` ```text wrap theme={null} Leggi un foglio di calcolo da Google Drive e importa i suoi dati nella mia app. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/google-docs). **Prompt di esempio** Descrivi nella chat AI il documento, cosa lo avvia ed eventuali campi dinamici. Ad esempio: ```text wrap theme={null} Genera automaticamente documenti con le note delle riunioni. ``` ```text wrap theme={null} Crea contratti da modelli con i dati dei clienti. ``` ```text wrap theme={null} Aggiorna i documenti condivisi quando cambia lo stato del progetto. ``` ```text wrap theme={null} Esporta i report in formato Google Docs. ``` ```text wrap theme={null} 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](https://base44.com/integrations/connectors/google-sheets). **Prompt di esempio** Descrivi nella chat AI il foglio di calcolo, cosa avvia l'azione ed eventuali campi dinamici. Ad esempio: ```text wrap theme={null} Esporta i dati dell'app in un foglio di calcolo Google Sheets. ``` ```text wrap theme={null} Importa i lead da un foglio Google Sheets nel CRM. ``` ```text wrap theme={null} Aggiorna automaticamente le quantità di magazzino in Google Sheets. ``` ```text wrap theme={null} Crea report settimanali e salvali in Google Sheets. ``` ```text wrap theme={null} 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](https://docs.base44.com/it/Integrations/Connectors.md#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. > [!TIP] > > 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](https://docs.base44.com/it/Community-and-support/Contacting-support.md) per tempo. Requisiti, tempi ed eccezioni li decide Google, quindi consulta la [documentazione per sviluppatori di Google](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification) prima di pianificare. > [!NOTE] > > 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** ```javascript theme={null} // One account the whole app uses const { accessToken } = await base44.asServiceRole.connectors.getConnection("googlecalendar"); // Use the access token to call the Google Calendar API. ``` **Connettore per utenti dell'app** ```javascript theme={null} // 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](https://docs.base44.com/it/developers/backend/resources/connectors/shared-connectors.md)** > > Configura, distribuisci e chiama una connessione condivisa da una funzione backend. > **[Connettori per utenti dell'app](https://docs.base44.com/it/developers/backend/resources/connectors/app-user-connectors.md)** > > 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](https://docs.base44.com/it/Integrations/Connectors.md#visualizzare-i-tuoi-url-di-callback). > [!NOTE] > > Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.