Il connettore Microsoft OneDrive per Gemini Enterprise ti consente di accedere a Microsoft OneDrive e interagire con i tuoi file e le tue cartelle.
Versioni di Microsoft OneDrive supportate
Il connettore Microsoft OneDrive supporta tutte le versioni ospitate di Microsoft OneDrive tramite l'API Microsoft Graph v1.0.
Azioni supportate
Quando il connettore Microsoft OneDrive è abilitato, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.
| Azione | Descrizione |
|---|---|
| Crea cartella | Crea una nuova cartella in un percorso specificato in Microsoft OneDrive. |
| Copia file | Copia un file da un'origine a una destinazione in Microsoft OneDrive. |
Autorizzazioni obbligatorie
Per consentire a Gemini Enterprise di eseguire la ricerca e l'importazione dati utilizzando il datastore Microsoft OneDrive, devi disporre delle seguenti autorizzazioni:
Autorizzazioni API Microsoft Graph
La tabella seguente descrive le autorizzazioni richieste per ogni modalità di connessione.
Nota:la tabella seguente illustra le autorizzazioni richieste per ogni modalità di connessione. Se attivi Azioni per la modalità di connessione Ricerca federata o Importazione dati, seleziona anche le autorizzazioni elencate nella riga Azioni.
| Modalità di connessione | Ambito | Purpose |
|---|---|---|
| Ricerca federata | Files.Read.All |
(Delegata) Consente al connettore di leggere tutti i file a cui l'utente può accedere. |
Sites.Read.All |
(Delegato) Consente al connettore di leggere documenti ed elenchi di elementi in tutte le raccolte di siti a cui l'utente può accedere. | |
| Importazione dati | GroupMember.Read.All |
(Credenziali federate e token di aggiornamento OAuth 2.0) Consente al connettore di leggere le iscrizioni e le proprietà di base dei gruppi per tutti i gruppi senza un utente che ha eseguito l'accesso. |
User.Read |
(Credenziali federate e token di aggiornamento OAuth 2.0) Consente al connettore di leggere il profilo degli utenti che hanno eseguito l'accesso. Consente inoltre al connettore di leggere le informazioni di base sull'azienda degli utenti che hanno eseguito l'accesso. | |
User.Read.All |
(Solo token di aggiornamento OAuth 2.0) Consente al connettore di leggere i profili utente. | |
Sites.FullControl.All (Opzione 1)Sites.Selected (Opzione 2) |
(Credenziali federate e token di aggiornamento OAuth 2.0) L'opzione 1 consente al connettore di avere il controllo completo di tutte le raccolte di siti. L'opzione 2 consente al connettore di accedere a un sottoinsieme di raccolte di siti. Le raccolte siti specifiche e le autorizzazioni concesse possono essere configurate in Microsoft OneDrive. | |
User.Read.All (Opzione 1)User.ReadBasic.All (Opzione 2) |
(Solo credenziali federate) L'opzione 1 consente al connettore di leggere i profili utente. L'opzione 2 consente al connettore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione. | |
| Azioni | Files.ReadWrite.AppFolder |
(Delegato) Consente al connettore di leggere, creare, aggiornare ed eliminare file nella cartella Microsoft OneDrive. |
Files.ReadWrite |
(Delegato) Consente al connettore di leggere, creare, aggiornare ed eliminare i file a cui l'utente può accedere. |
Per informazioni su come aggiungere le autorizzazioni per Microsoft OneDrive, vedi Configurare Microsoft OneDrive e impostare le autorizzazioni necessarie.
Limitazioni
Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del connettore Microsoft OneDrive.
L'applicazione di un perimetro di Controlli di servizio VPC ai datastore Microsoft OneDrive esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli attivati, consulta Proteggere l'app con i Controlli di servizio VPC.
Il datastore Microsoft OneDrive è supportato solo nelle località globali, US ed EU.
Quando crei una nuova applicazione o aggiungi un datastore a un'applicazione esistente, ti consigliamo di aggiungere un datastore con azioni appartenenti a un singolo tipo di connettore. Ad esempio, non associare due datastore Microsoft OneDrive con azioni attivate alla stessa applicazione.
Di seguito sono riportate le limitazioni per il connettore federato Microsoft OneDrive:
- Limitazioni della ricerca: i risultati di ricerca possono variare e non sono sempre esaustivi per tutti i tipi di file. I contenuti nelle cartelle archiviate o criptate potrebbero non essere accessibili per la ricerca. La ricerca federata non supporta la ricerca all'interno degli allegati.
- Accesso delegato:l'accesso a file o cartelle di Microsoft OneDrive condivisi potrebbe richiedere autorizzazioni specifiche non coperte dall'autorizzazione utente standard.
Di seguito sono riportate le limitazioni per il connettore di importazione di Microsoft OneDrive:
- La sincronizzazione incrementale non rileva le azioni a livello di cartella come Copia, Sposta o Rinomina.
Passaggi successivi
- Per creare e configurare un connettore con Microsoft OneDrive, consulta Configurare un datastore Microsoft OneDrive.