Collega il tuo account Google Drive a Goodweek per accedere, caricare e gestire file e cartelle archiviati in Google Drive 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 Drive, garantendo così la conformità 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 Google Drive, 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 amministratore. Connettiti direttamente seguendo i passaggi di Connessione utente riportati di seguito.
Account Google Workspace (lavoro o istituto scolastico)
Google Drive richiede ambiti di accesso ai file molto ampi, che gli amministratori di Google Workspace segnalano comunemente come ad alto rischio. Questo rende più probabile una restrizione amministrativa per Drive rispetto ad altre integrazioni Google.
Scenario 1: predefinito (accesso di terze parti senza restrizioni)
Qualsiasi utente può connettersi 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 accesso app di terze parti.
Fai clic su Configura nuova app, cerca Composio, selezionala, imposta l'accesso su Attendibile e fai clic su Salva.
Scenario 3: tutto l'accesso API di terze parti è bloccato
Vai su admin.google.com → Sicurezza → Controlli API e rivedi l'impostazione "Accesso delle app di terze parti alle API di Google". Se bloccato, l'amministratore deve creare un'eccezione per Composio prima di seguire lo Scenario 2.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova Google Drive e fai clic su Connetti.
Verrai reindirizzato a Google, dove ti verrà chiesto di accedere.
Rivedi le autorizzazioni richieste e fai clic su Consenti per tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account individualmente.
Goodweek può accedere solo ai file e alle cartelle che il tuo account utente individuale ha il permesso di vedere. I file 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 |
Find File | Ricerca completa in Google Drive di file e cartelle per nome, tipo, contenuto e altri filtri. | Lettura |
Find Folder | Trova cartelle per nome all'interno di una cartella principale in Google Drive. | Lettura |
Get File Metadata | Recupera i metadati di un file tramite ID, inclusi tipo, cartelle principali e stato nel cestino. | Lettura |
Download a File from Google Drive | Scarica un file da Google Drive tramite il suo ID, con formato di esportazione opzionale per i documenti Google Workspace. | Lettura |
Export Google Workspace File | Esporta un documento Google Workspace (Docs, Sheets, Slides) in un tipo MIME richiesto, come PDF o DOCX. | Lettura |
Create File or Folder | Crea un nuovo file o cartella in Google Drive, con supporto per la creazione di soli metadati e il caricamento di file con contenuto. | Scrittura |
Create a File from Text | Crea un nuovo file in Google Drive a partire dal contenuto testuale fornito, con conversione opzionale nei formati Google Workspace. | Scrittura |
Create a Folder | Crea una nuova cartella in Google Drive, facoltativamente all'interno di una cartella principale esistente. | Scrittura |
Upload File | Carica un file (massimo 5 MB) su Google Drive, posizionandolo nella cartella specificata o nella radice. | Scrittura |
Upload File from URL to Drive | Recupera un file da un URL pubblico e lo carica direttamente in Google Drive. | Scrittura |
Upload/Update File Content | Sostituisce il contenuto di un file esistente in Google Drive con nuovo contenuto. | Scrittura |
Edit File | Aggiorna un file di testo esistente in Google Drive sovrascrivendo l'intero contenuto (massimo 10 MB). | Lettura |
Move File | Sposta un file da una cartella a un'altra in Google Drive. | Lettura |
Copy File with Advanced Options | Crea una copia di un file con aggiornamenti opzionali applicati tramite semantica patch. | Lettura |
Create Shortcut to File/Folder | Crea un collegamento a un elemento Drive esistente da un'altra posizione senza duplicarlo. | Scrittura |
Create Permission | Condivide un file o una cartella con un utente, un gruppo o un dominio creando una nuova autorizzazione. | Scrittura |
Create Permissions Batch | Crea più autorizzazioni di condivisione per file o unità condivise in un'unica richiesta batch. | Scrittura |
List Permissions | Recupera tutte le autorizzazioni associate a un file o a un'unità condivisa specifici. | Lettura |
Update Permission | Modifica un'autorizzazione di condivisione esistente per un file o un'unità condivisa. | Scrittura |
Create Comment | Crea un commento su un file di Google Drive. | Scrittura |
List Comments | Elenca tutti i commenti di un file in Google Drive con paginazione. | Lettura |
Update Comment | Aggiorna il contenuto di un commento esistente su un file di Google Drive. | Scrittura |
Create Reply | Crea una risposta a un commento su un file di Google Drive. | Scrittura |
List File Revisions | Elenca i metadati della cronologia delle revisioni di un file in Google Drive. | Lettura |
Create Shared Drive | Crea una nuova unità condivisa per la collaborazione in team. | Scrittura |
List Shared Drives | Elenca tutte le unità condivise accessibili all'utente autenticato. | Lettura |
Untrash File | Ripristina un file dal cestino. | Scrittura |
Get About | Recupera informazioni sull'utente, sulla sua quota di archiviazione Drive e sulle funzionalità del sistema. | Lettura |
Delete Permission | Revoca un'autorizzazione di condivisione da un file. Questa azione è irreversibile. | ⚠️ Distruttivo |
Trash File | Sposta un file o una cartella nel cestino (eliminazione reversibile, recuperabile). | ⚠️ Distruttivo |
Delete Folder or File | Elimina definitivamente un file o una cartella da Google Drive. Questa azione è irreversibile. | ⚠️ Distruttivo |
Empty Trash | Elimina in modo permanente e irreversibile tutti i file nel cestino di Google Drive dell'utente. | ⚠️ Distruttivo |
Casi d'uso
Trova e recupera file su richiesta. Cerca nel tuo Google Drive per nome, tipo o contenuto e porta i metadati o il contenuto dei file in una conversazione Goodweek senza navigare nell'interfaccia di Drive.
Carica e organizza i file in Drive. Carica nuovi file in una cartella specifica, crea strutture di cartelle o sposta file esistenti tra posizioni direttamente da Goodweek.
Condividi file con persone o team specifici. Concedi o aggiorna le autorizzazioni di condivisione su file e cartelle direttamente da Goodweek, senza aprire manualmente le impostazioni di Drive.
Esporta documenti Google Workspace. Esporta un Google Doc, Sheet o Slide in PDF o in un altro formato direttamente da Goodweek per la condivisione o l'archiviazione.
Risoluzione dei problemi
"Errore 400: admin_policy_enforced" durante la connessione
L'amministratore della tua organizzazione ha limitato l'accesso alle app di terze parti. Gli ampi ambiti di accesso ai file di Google Drive rendono questo caso particolarmente comune. Solo un Super Admin di Google Workspace può risolvere il problema seguendo lo Scenario 2 sopra.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Google Drive dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.