Panoramica

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.All
User.ReadBasic.All
Elenco dei proprietari dei gruppi Sola lettura Elenca i proprietari di un gruppo nella directory. GroupMember.Read.All
User.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.All
Files.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.All
Files.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.ReadWrite
Calendars.ReadWrite
Crea calendario Scrittura Crea un nuovo calendario nella casella di posta dell'utente. Calendars.ReadWrite
Calendars.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.ReadWrite
Mail.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.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
Elenco canali Sola lettura Elenca i canali in un team Microsoft. Channel.ReadBasic.All
Group.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.Read
ChannelMessage.Read.All
Group.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.Read
ChannelMessage.Read.All
Group.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, us e eu.

  • 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