Panoramica

Il datastore di Google Drive per Gemini Enterprise ti consente di eseguire ricerche e azioni sui dati di Google Drive, inclusi file e cartelle.

Nota: Gemini Enterprise ha rilasciato nuovi connettori dati di Google Workspace per Google Drive, Gmail, Google Chat e Google Calendar. I nuovi connettori utilizzano un'app OAuth gestita da Google, quindi non devi più creare il tuo client OAuth o fornire un ID client e un client secret quando crei il datastore. Per istruzioni sulla configurazione di Google Drive, consulta Configura un datastore Google Drive.

Azioni supportate

Quando il datastore di Google Drive è abilitato, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.

Azione	Descrizione
Copia file	Copia un file su Google Drive.
Crea file	Crea un nuovo file su Google Drive.
Scarica i contenuti del file	Scarica i contenuti di un file di Google Drive.
Recupera i valori delle celle	Legge i valori delle celle da un foglio di lavoro di Fogli Google.
Recupera i metadati del file	Recupera i metadati di un file di Google Drive.
Ottieni le autorizzazioni dei file	Elenca le autorizzazioni per un file di Google Drive.
Scarica il foglio di lavoro	Legge i contenuti e i metadati di un foglio di lavoro di Fogli Google.
Inserisci dimensione	Inserisce righe o colonne in un foglio di lavoro di Fogli Google.
Elenca i file recenti	Elenca i file recenti su Google Drive.
Elenca i Drive condivisi	Elenca i Drive condivisi su Google Drive.
Documento letto	Legge i contenuti di un documento di Documenti Google.
Leggi i contenuti dei file	Legge i contenuti di un file di Google Drive.
Leggi la presentazione	Legge i contenuti di una presentazione Google.
Cercare file	Cerca i file di Google Drive corrispondenti a una query.
Condividi file	Condivide un file di Google Drive con uno o più utenti.
Sposta file nel cestino	Sposta un file di Google Drive nel cestino.
Aggiorna i valori delle celle	Scrive i valori delle celle in un foglio di lavoro di Fogli Google.
Aggiorna file	Aggiorna un file di Google Drive esistente.
Aggiorna formule	Scrive formule in un foglio di lavoro di Fogli Google.

Nota: la dimensione massima dei file per i caricamenti e i download in Gemini Enterprise è di 75 MB.

Ambiti obbligatori

L'app OAuth gestita da Googlerichiede i seguenti ambiti OAuth. Gli utenti concedono questi ambiti quando autorizzano il connettore:

Ambito	Finalità
https://www.googleapis.com/auth/drive.readonly	Cercare e recuperare i contenuti di Google Drive. Consente al datastore di elencare file e cartelle, visualizzare i metadati, elencare le autorizzazioni e leggere i contenuti dei file.
https://www.googleapis.com/auth/drive.metadata.readonly	Leggere i metadati dei file di Google Drive.
https://www.googleapis.com/auth/drive.file	Creare e aggiornare i file che l'utente apre o crea con il connettore.
https://www.googleapis.com/auth/drive.appdata	Archivia i dati specifici dell'applicazione su Google Drive.
https://www.googleapis.com/auth/drive	Eseguire azioni di scrittura sui file di Google Drive (ad esempio copia, condivisione, spostamento nel cestino e aggiornamento).

Limitazioni

• Il datastore di Google Drive è supportato solo nelle località global, us e eu.

• Se utilizzi controlli di sicurezza, tieni presente le loro limitazioni relative ai dati in Google Drive, come descritto nella seguente tabella:

  Controllo di sicurezza	Tieni presente quanto segue
  Residenza dei dati (DRZ)	Gemini Enterprise garantisce la residenza dei dati solo in Google Cloud. Per informazioni sulla residenza dei dati e su Google Drive, consulta le linee guida e la documentazione sulla conformità di Google Workspace, tra cui Regioni di dati per Google Workspace. Esamina anche esempi come scegliere la regione in cui vengono archiviati i dati e Sovranità digitale.
  Chiavi di crittografia gestite dal cliente (CMEK)	Le tue chiavi criptano solo i dati all'interno di Google Cloud. I controlli di Cloud Key Management Service non si applicano ai dati archiviati in Google Drive.
  Access Transparency	Access Transparency registra le azioni intraprese dal personale Google sul progetto Google Cloud . Dovrai anche esaminare i log di Access Transparency creati da Google Workspace. Per ulteriori informazioni, vedi Eventi dei log di Access Transparency nella documentazione del Centro assistenza per gli amministratori di Google Workspace.

Problemi di ricerca comuni

Se la ricerca non restituisce il file che stai cercando, il problema potrebbe essere dovuto a una delle seguenti limitazioni dell'indice di ricerca di Google Drive:

• Google Drive estrae solo 1 MB di testo e dati di formattazione dal file per renderlo disponibile per la ricerca. Le parole chiave che superano il limite di 1 MB dell'indice non sono disponibili per la ricerca.

• Per la maggior parte dei tipi di file, le dimensioni non possono superare i 10 MB. Di seguito sono riportate le eccezioni:

  • I file XLSX (.xlsx) non possono superare i 20 MB.

  • I file PDF (.pdf) non possono superare i 30 MB.

  • I file di testo (.txt) non possono superare i 100 MB.

  Nota: i file che superano il limite di dimensioni non sono disponibili per la ricerca e non vengono visualizzati nei risultati di ricerca.

• Il riconoscimento ottico dei caratteri nei file PDF è limitato a 80 pagine. Google Drive non indicizza i PDF di dimensioni superiori a 50 MB o 80 pagine.

Passaggi successivi

• Per creare e configurare un datastore con Google Drive, consulta Configura un datastore Google Drive.