Panoramica

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

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

Azioni supportate

Quando il datastore 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 il contenuto del file	Scarica il contenuto di un file di Google Drive.
Recupera i metadati del file	Recupera i metadati di un file di Google Drive.
Recupera le autorizzazioni per i file	Elenca le autorizzazioni per un file di Google Drive.
Elenca i file recenti	Elenca i file recenti su Google Drive.
Leggi il contenuto del file	Legge i contenuti di un file di Google Drive.
Cerca file	Cerca i file di Google Drive che corrispondono a una query.
Condividi file	Condivide un file di Google Drive con uno o più utenti.
Sposta il file nel cestino	Sposta un file di Google Drive nel cestino.
Aggiorna file	Aggiorna un file di Google Drive esistente.

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

Ambiti obbligatori

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

Ambito	Finalità
https://www.googleapis.com/auth/drive.readonly	Cerca e recupera i contenuti di Google Drive. Consente al datastore di elencare file e cartelle, visualizzare i metadati, elencare le autorizzazioni e leggere il contenuto dei file.
https://www.googleapis.com/auth/drive.metadata.readonly	Leggi i metadati dei file di Google Drive.
https://www.googleapis.com/auth/drive.file	Crea e aggiorna 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	Esegui azioni di scrittura sui file di Google Drive (ad esempio, copia, condividi, sposta nel cestino e aggiorna).

Limitazioni

• Il datastore Google Drive è supportato solo nelle località global, us ed 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, vedi Configurare un Google datastore Drive.