Il connettore Microsoft 365 per Gemini Enterprise ti consente di cercare e agire sui dati di Microsoft 365 da un unico connettore: siti SharePoint, file OneDrive, posta di Outlook, calendari di Outlook, contatti e Microsoft Teams. Il connettore raggiunge tutte queste piattaforme tramite l'API Microsoft Graph.
Poiché un connettore copre tutte le piattaforme Microsoft 365, non è necessario creare un datastore separato per SharePoint, OneDrive, Outlook e Teams.
Il connettore supporta due metodi di autenticazione OAuth 2.0:
- OAuth gestito daGoogle(predefinito): il connettore utilizza un'applicazione Microsoft Entra gestita da Google . Non devi registrare la tua applicazione o fornire un ID client e un client secret.
- Utilizza la tua app: registra la tua applicazione Microsoft Entra e fornisci l'ID tenant, l'ID client e il client secret quando configuri il datastore.
Per saperne di più, consulta Configurazione di Microsoft 365.
Azioni supportate
Quando il connettore Microsoft 365 è abilitato, gli utenti finali possono utilizzare comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni. Le azioni sono raggruppate in base al prodotto Microsoft 365 su cui agiscono, il che corrisponde al modo in cui sono raggruppate quando selezioni le azioni nella consoleGoogle Cloud . Per ogni azione, le tabelle mostrano se legge solo i dati o se apporta anche modifiche, nonché le autorizzazioni delegate di Microsoft Graph necessarie. Per informazioni su come vengono richieste e concesse le autorizzazioni, consulta Autorizzazioni.
Utenti e gruppi
| Azione | Tipo | Descrizione | Autorizzazioni obbligatorie |
|---|---|---|---|
| Aggiungi membro del gruppo | Scrittura | Aggiunge un utente come membro di un gruppo. | GroupMember.ReadWrite.All |
| Aggiungi proprietario del gruppo | Scrittura | Aggiunge un utente come proprietario di un gruppo. | Group.ReadWrite.All |
| Crea gruppo | Scrittura | Crea un nuovo gruppo Microsoft 365. | Group.ReadWrite.All |
| Ottieni il mio profilo | Sola lettura | Recupera il profilo dell'utente che ha eseguito l'accesso, incluso l'indirizzo email su cui è basato il suo account Microsoft. | User.Read |
| Ottieni profilo utente | Sola lettura | Recupera il profilo di un utente nella directory. | User.ReadBasic.All |
| Ottieni il profilo di lavoro dell'utente | Sola lettura | Recupera la qualifica, il reparto, l'ufficio, i numeri di telefono, il responsabile e i collaboratori diretti di un utente. | User.Read.All |
| Elenca membri di gruppi | Sola lettura | Elenca i membri diretti di un gruppo nella directory. | Group.ReadBasic.AllUser.ReadBasic.All |
| Elenco dei proprietari dei gruppi | Sola lettura | Elenca i proprietari di un gruppo nella directory. | GroupMember.Read.AllUser.ReadBasic.All |
| Elenca gruppi | Sola lettura | Trova i gruppi nella directory in base al nome e restituisce l'ID di ogni gruppo. | Group.ReadBasic.All |
| Trovare persone nella directory | Sola lettura | Trova le persone nella directory dell'organizzazione per nome o indirizzo email. | User.ReadBasic.All |
| Aggiorna gruppo | Scrittura | Aggiorna il nome, la descrizione o la visibilità di un gruppo. | Group.ReadWrite.All |
SharePoint e OneDrive
| Azione | Tipo | Descrizione | Autorizzazioni obbligatorie |
|---|---|---|---|
| Ottieni intervallo Excel | Sola lettura | Legge i valori delle celle in un blocco di celle di un foglio di lavoro, incluse le celle esterne a una tabella. | Files.Read.All |
| Ottieni riga della tabella Excel | Sola lettura | Legge una riga di una tabella in una cartella di lavoro di Excel, con le intestazioni di colonna della tabella. | Files.Read.All |
| Ottieni righe della tabella Excel | Sola lettura | Legge le righe di dati di una tabella in una cartella di lavoro di Excel, con le intestazioni di colonna della tabella. | Files.Read.All |
| Elenca tabelle Excel | Sola lettura | Elenca le tabelle formattate in una cartella di lavoro di Excel e il foglio di lavoro in cui si trovano. | Files.Read.All |
| Ottieni le proprietà della cartella di lavoro di Excel | Sola lettura | Legge le proprietà del file di una cartella di lavoro di Excel: nome, dimensioni, URL e chi l'ha modificato l'ultima volta. | Files.Read.All |
| Scarica il foglio di lavoro Excel | Sola lettura | Legge un foglio di lavoro di una cartella di lavoro Excel e l'estensione dei dati al suo interno. | Files.Read.All |
| Elenca fogli di lavoro Excel | Sola lettura | Elenca i fogli di lavoro di una cartella di lavoro Excel, in ordine di scheda. | Files.Read.All |
| Elenca cartelle di lavoro Excel | Sola lettura | Trova le cartelle di lavoro di Excel nei siti di OneDrive e SharePoint a cui l'utente può accedere. | Sites.Read.AllFiles.Read.All |
| Archivia documento | Scrittura | Esegue il check-in di un documento, rilasciando il blocco di modifica e rendendolo disponibile ad altri. | Files.ReadWrite.All |
| Esegui il checkout del documento | Scrittura | Esegue il check-out di un documento, bloccandolo per la modifica esclusiva. | Files.ReadWrite.All |
| Copia file | Scrittura | Copia un file in una nuova posizione. | Files.ReadWrite.All |
| Copia cartella | Scrittura | Copia una cartella in una nuova posizione. | Files.ReadWrite.All |
| Crea file | Scrittura | Crea un nuovo file con un nome specifico all'interno di una cartella. Non sovrascrive mai un file esistente; per farlo, utilizza Sostituisci i contenuti del file. | Files.ReadWrite.All |
| Crea cartella | Scrittura | Crea una nuova cartella all'interno di una cartella esistente. | Files.ReadWrite.All |
| Crea link di condivisione | Scrittura | Crea un link condivisibile a un file o a una cartella. | Files.ReadWrite.All |
| Ignora checkout | Scrittura | Annulla il check-out di un documento e ignora le modifiche in attesa. | Files.ReadWrite.All |
| Recupera file o cartella tramite URL | Sola lettura | Trova il file o la cartella a cui punta un link di SharePoint o OneDrive, in modo che possa essere letto o utilizzato. | Files.Read.All |
| Scarica i contenuti del file | Sola lettura | Scarica i contenuti non elaborati di un file archiviato su un Drive. | Files.Read.All |
| Ottieni il mio OneDrive | Sola lettura | Recupera l'account OneDrive dell'utente che ha eseguito l'accesso, in modo che i file possano essere salvati o elencati nel livello superiore, e segnala la quota di spazio di archiviazione. | Files.Read.All |
| Elenca i contenuti della cartella | Sola lettura | Elenca i file e le cartelle all'interno di una cartella in un Drive. | Files.Read.All |
| Elenco delle autorizzazioni dei file | Sola lettura | Elenca le autorizzazioni di condivisione impostate su un file o una cartella. | Files.Read.All |
| Sposta file | Scrittura | Sposta un file in un'altra cartella. | Files.ReadWrite.All |
| Sposta cartella | Scrittura | Sposta una cartella in un'altra cartella principale. | Files.ReadWrite.All |
| Rinomina file | Scrittura | Rinomina un file. | Files.ReadWrite.All |
| Rinomina cartella | Scrittura | Rinomina una cartella. | Files.ReadWrite.All |
| Sostituisci contenuto del file | Scrittura | Sostituisce l'intero contenuto di un file già esistente. Per creare un nuovo file, utilizza Crea file. | Files.ReadWrite.All |
| Invia invito di condivisione | Scrittura | Invia un invito alla condivisione di un file o di una cartella. | Files.ReadWrite.All |
| Aggiorna le proprietà di file o cartelle | Scrittura | Aggiorna le proprietà di un file o di una cartella (nome, descrizione, cartella principale). | Files.ReadWrite.All |
| Crea un elenco di SharePoint | Scrittura | Crea un nuovo elenco su un sito SharePoint. | Sites.Manage.All |
| Crea elemento dell'elenco | Scrittura | Crea un nuovo elemento in un elenco di SharePoint. | Sites.ReadWrite.All |
| Crea pagina SharePoint | Scrittura | Crea una nuova pagina su un sito SharePoint. | Sites.ReadWrite.All |
| Recupera voce elenco | Sola lettura | Recupera una singola riga di un elenco SharePoint, con i relativi valori di colonna. | Sites.Read.All |
| Ottieni i contenuti della pagina di SharePoint | Sola lettura | Recupera il corpo HTML di una pagina SharePoint. | Sites.Read.All |
| Elenca le voci dell'elenco | Sola lettura | Legge le righe di un elenco di SharePoint, con i valori delle colonne di ogni riga. | Sites.Read.All |
| List SharePoint lists (Elenca gli elenchi di SharePoint) | Sola lettura | Elenca gli elenchi SharePoint di un sito, inclusi l'ID e il modello di ogni elenco. | Sites.Read.All |
| Elenca le pagine di SharePoint | Sola lettura | Elenca le pagine di un sito SharePoint, con il titolo, l'URL e lo stato di pubblicazione di ogni pagina. | Sites.Read.All |
| Cerca in SharePoint e OneDrive | Sola lettura | Cerca siti, pagine, elementi di elenco di SharePoint e file di OneDrive a cui l'utente può accedere. | Sites.Read.AllFiles.Read.All |
| Aggiorna elenco di SharePoint | Scrittura | Aggiorna le proprietà di un elenco di SharePoint (nome, descrizione). | Sites.Manage.All |
| Aggiorna elemento elenco | Scrittura | Aggiorna i campi di un elemento di un elenco SharePoint esistente. | Sites.ReadWrite.All |
| Aggiorna pagina di SharePoint | Scrittura | Aggiorna il titolo o il nome file di una pagina di SharePoint. | Sites.ReadWrite.All |
Outlook
| Azione | Tipo | Descrizione | Autorizzazioni obbligatorie |
|---|---|---|---|
| Aggiungi allegato | Scrittura | Aggiunge un file allegato a un'email o a un evento nel calendario esistente. | Mail.ReadWriteCalendars.ReadWrite |
| Crea calendario | Scrittura | Crea un nuovo calendario nella casella di posta dell'utente. | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Crea contatto | Scrittura | Crea un nuovo contatto nella cartella Contatti dell'utente. | Contacts.ReadWrite |
| Crea una bozza di messaggio | Scrittura | Crea una bozza di email nella casella di posta dell'utente. | Mail.ReadWriteMail.ReadWrite.Shared |
| Crea evento nel calendario | Scrittura | Crea un nuovo evento nel calendario dell'utente. | Calendars.ReadWrite |
| Crea una bozza di risposta | Scrittura | Crea una bozza di risposta al mittente di un'email esistente. | Mail.ReadWriteMail.ReadWrite.Shared |
| Trova orari per una riunione | Sola lettura | Suggerisce gli orari delle riunioni in base alla disponibilità dei partecipanti. | Calendars.Read.Shared |
| Inoltra messaggio | Scrittura | Inoltra un'email esistente ai destinatari specificati. | Mail.Send |
| Recupera allegato del messaggio email | Sola lettura | Recupera i byte di un file allegato da un messaggio nella casella di posta dell'utente. | Mail.Read |
| Ricevi risposte automatiche | Sola lettura | Recupera l'impostazione di risposta automatica (fuori sede) di Outlook dell'utente. | MailboxSettings.Read |
| Scarica evento del calendario | Sola lettura | Recupera un evento dal calendario di Outlook dell'utente, incluse le risposte dei partecipanti e gli ID degli allegati. | Calendars.Read |
| Scarica allegato evento del calendario | Sola lettura | Recupera i byte di un file allegato da un evento nel calendario dell'utente. | Calendars.Read |
| Recupera messaggio email | Sola lettura | Recupera un singolo messaggio dalla casella di posta dell'utente. | Mail.Read |
| Ottieni la disponibilità della programmazione | Sola lettura | Recupera la disponibilità (libero/occupato) di utenti, stanze o attrezzature in un intervallo di tempo. | Calendars.Read |
| Elenca gli eventi nel calendario | Sola lettura | Elenca gli eventi nel calendario dell'utente in un intervallo di tempo. | Calendars.Read |
| Elenca calendari | Sola lettura | Elenca i calendari nella casella di posta dell'utente. | Calendars.Read |
| Elenca le categorie di Outlook | Sola lettura | Elenca le categorie (etichette) nell'elenco delle categorie di Outlook dell'utente. | MailboxSettings.Read |
| Elenco contatti | Sola lettura | Elenca o cerca i contatti nella rubrica di Outlook dell'utente. | Contacts.Read |
| Elenca le regole della posta in arrivo | Sola lettura | Elenca le regole della Posta in arrivo di Outlook dell'utente. | MailboxSettings.Read |
| Elenca cartelle di posta | Sola lettura | Elenca le cartelle di posta nella casella di posta dell'utente. | Mail.ReadBasic |
| Elenca i messaggi in una cartella | Sola lettura | Elenca i messaggi in una delle cartelle di posta dell'utente, ad esempio la Posta in arrivo o gli elementi inviati. | Mail.Read |
| Elenca o cerca una casella di posta condivisa | Sola lettura | Elenca o cerca i messaggi in una casella di posta condivisa o delegata a cui l'utente ha accesso. | Mail.Read.Shared |
| Sposta messaggio | Scrittura | Sposta un'email in un'altra cartella di posta. | Mail.ReadWrite |
| Rispondi a tutti nel messaggio | Scrittura | Risponde a un'email esistente, al mittente e a tutti gli altri destinatari, mantenendo la risposta nella conversazione originale. | Mail.Send |
| Rispondi al messaggio | Scrittura | Risponde a un'email esistente, al mittente, mantenendo la risposta nella conversazione originale. | Mail.Send |
| Parteciperai all'evento | Scrittura | Risponde a un invito a una riunione (accetta, accetta provvisoriamente o rifiuta). | Calendars.ReadWrite |
| Cerca email | Sola lettura | Cerca nella posta di Outlook dell'utente per parola chiave. | Mail.Read |
| Cerca email in una cartella | Sola lettura | Cerca i messaggi in una delle cartelle di posta dell'utente, incluse le sottocartelle come Posta in arrivo/Fatture, per parola chiave, mittente o oggetto. | Mail.Read |
| Cerca eventi nel calendario | Sola lettura | Cerca gli eventi nel calendario Outlook dell'utente per parola chiave. | Calendars.Read |
| Invia bozza di messaggio | Scrittura | Invia una bozza di email esistente. | Mail.Send |
| Invia email | Scrittura | Scrive e invia un nuovo messaggio email. | Mail.Send |
| Aggiorna calendario | Scrittura | Aggiorna le proprietà di un calendario esistente (nome, colore o stato predefinito). | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Aggiorna contatto | Scrittura | Aggiorna le proprietà di un contatto esistente. | Contacts.ReadWrite |
| Aggiorna evento | Scrittura | Aggiorna le proprietà di un evento nel calendario esistente. | Calendars.ReadWrite |
| Aggiorna messaggio | Scrittura | Aggiorna le proprietà di un messaggio email esistente (ad es. contrassegna come letto, modifica i flag o l'importanza). | Mail.ReadWrite |
| Elenca gli elenchi di attività | Sola lettura | Elenca gli elenchi di attività di Microsoft To Do (Attività di Outlook) dell'utente. | Tasks.Read |
| Elenca attività | Sola lettura | Elenca le attività in uno degli elenchi di Microsoft To Do (Attività di Outlook) dell'utente. | Tasks.Read |
Team
| Azione | Tipo | Descrizione | Autorizzazioni obbligatorie |
|---|---|---|---|
| Aggiungi membro al canale | Scrittura | Aggiunge un utente a un canale Teams privato o condiviso. | ChannelMember.ReadWrite.All |
| Crea canale | Scrittura | Crea un nuovo canale all'interno di un team di Teams. | Channel.Create |
| Crea chat | Scrittura | Crea una nuova chat di Teams (chat individuale, di gruppo o di riunione). | Chat.Create |
| Crea riunione | Scrittura | Crea una nuova riunione online di Teams. | OnlineMeetings.ReadWrite |
| Crea gruppo di pianificazione | Scrittura | Crea un gruppo di programmazione all'interno di una programmazione di Teams. | Schedule.ReadWrite.All |
| Crea voce di assenza | Scrittura | Crea una voce di assenza per un utente in una pianificazione di Teams. | Schedule.ReadWrite.All |
| Crea motivo del tempo di riposo | Scrittura | Crea un nuovo motivo di assenza (ad es. ferie, congedo per malattia) per una programmazione di Teams. | Schedule.ReadWrite.All |
| Ottieni programmazione | Sola lettura | Legge le impostazioni della pianificazione dei turni e lo stato di provisioning di un team. | Schedule.Read.All |
| Elenca gli abbonati al canale | Sola lettura | Elenca i membri di un canale di Teams e i loro ruoli. | ChannelMember.Read.All |
| Elenca i messaggi del canale | Sola lettura | Elenca i messaggi in un canale di Teams. | ChannelMessage.Read.AllGroup.ReadBasic.All |
| Elenco canali | Sola lettura | Elenca i canali in un team Microsoft. | Channel.ReadBasic.AllGroup.ReadBasic.All |
| Elenca i messaggi chat | Sola lettura | Elenca i messaggi in una chat di Teams. | Chat.Read |
| Elenca le chat | Sola lettura | Elenca le chat di Teams di cui l'utente fa parte. | Chat.ReadBasic |
| Elenca i team a cui hai partecipato | Sola lettura | Elenca i team di Microsoft Teams di cui l'utente è membro. | Team.ReadBasic.All |
| Elenca le risposte ai messaggi del canale | Sola lettura | Legge un thread di un canale di Teams: il primo post e le risposte sottostanti. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Elenca i gruppi di pianificazione | Sola lettura | Elenca i gruppi di programmazione nella programmazione di Turni di un team. | Schedule.Read.All |
| Elenca le voci relative ai giorni di riposo | Sola lettura | Elenca i giorni di ferie prenotati nella pianificazione dei turni di un team. | Schedule.Read.All |
| Elenca i motivi dei giorni di ferie | Sola lettura | Elenca i motivi di assenza selezionabili nella pianificazione di Turni di un team. | Schedule.Read.All |
| Rispondi al messaggio del canale | Scrittura | Risponde a un messaggio in un canale di Teams. | ChannelMessage.Send |
| Eseguire ricerche nei messaggi di chat | Sola lettura | Cerca nei messaggi di chat e canali di Teams a cui l'utente può accedere. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Invia messaggio del canale | Scrittura | Pubblica un messaggio in un canale di Teams. | ChannelMessage.Send |
| Invia messaggio chat | Scrittura | Invia un messaggio in una chat di Teams. | ChatMessage.Send |
| Aggiorna canale | Scrittura | Aggiorna il nome o la descrizione di un canale di Teams. | ChannelSettings.ReadWrite.All |
| Aggiorna il messaggio del canale | Scrittura | Modifica un messaggio del canale pubblicato in precedenza. | ChannelMessage.ReadWrite |
| Aggiorna chat | Scrittura | Aggiorna l'argomento di una chat di gruppo di Teams. | Chat.ReadWrite |
| Aggiorna messaggio chat | Scrittura | Modifica un messaggio chat inviato in precedenza. | Chat.ReadWrite |
| Aggiorna gruppo di programmazione | Scrittura | Aggiorna il nome, lo stato attivo o i membri di un gruppo di programmazione. | Schedule.ReadWrite.All |
| Aggiorna team | Scrittura | Aggiorna il nome, la descrizione o la visibilità di un team di Teams. | TeamSettings.ReadWrite.All |
| Aggiorna la voce relativa al tempo libero | Scrittura | Aggiorna una voce di assenza esistente. | Schedule.ReadWrite.All |
Autorizzazioni
La colonna Autorizzazioni richieste nelle tabelle precedenti elenca le autorizzazioni delegate di Microsoft Graph necessarie per ogni azione. Gemini Enterprise richiede solo le autorizzazioni per le azioni che attivi, oltre alle seguenti, richieste da ogni connessione:
User.Read: legge il profilo dell'utente che ha eseguito l'accesso, che identifica l'account con cui agisce il connettore.offline_access: consente al connettore di aggiornare il proprio token di accesso senza chiedere all'utente di accedere di nuovo.
Tutte le autorizzazioni sono delegate: il connettore agisce come l'utente che ha eseguito l'accesso e può raggiungere solo i dati che l'utente può già raggiungere.
Con OAuth gestito da Google, gli utenti acconsentono a queste autorizzazioni quando autorizzano il connettore; alcune autorizzazioni richiedono il consenso di un amministratore di Microsoft Entra per l'organizzazione. Con la tua app, concedi queste autorizzazioni durante la registrazione dell'app. Per maggiori dettagli, vedi Configura le autorizzazioni API Microsoft.
Limitazioni
Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore di Microsoft 365.
- Quando crei una nuova app o aggiungi un datastore a un'app esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo tipo di connettore.
- L'applicazione di un perimetro dei Controlli di servizio VPC ai datastore Microsoft 365 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 Proteggi la tua app con i Controlli di servizio VPC.
- Il datastore di Microsoft 365 è supportato solo nelle località
global,useeu.
Il datastore di Microsoft 365 viene mappato uno a uno con un singolo tenant di Microsoft 365. Non può estendersi su più tenant isolati all'interno di un'organizzazione multi-tenant (MTO). Devi creare un datastore dedicato per ogni tenant distinto.
OAuth gestito daGooglesupporta solo i tenant nel cloud Microsoft commerciale (incluso GCC) e non supporta il traffico in uscita con IP statico. Per i tenant GCC High o DoD o per utilizzare l'uscita con IP statico, utilizza la tua app Microsoft Entra.
La migrazione delle caselle di posta a Exchange Online deve essere completata. Le caselle di posta ospitate on-premise in un ambiente Exchange ibrido non sono accessibili tramite l'API Microsoft Graph e le query su di esse possono restituire un errore
MailboxNotEnabledForRESTAPI.
Passaggi successivi
Per creare e configurare un datastore con Microsoft 365, consulta Configura un datastore Microsoft 365.
Per configurare l'applicazione Microsoft Entra con cui il connettore esegue l'autenticazione, consulta Configurazione di Microsoft 365.
Per visualizzare e gestire le azioni attivate, vedi Gestisci azioni.