Panoramica

Il datastore di Microsoft Outlook per Gemini Enterprise ti consente di cercare ed eseguire azioni su email, calendari, contatti e file di Microsoft 365 (cartelle di lavoro di Excel, documenti di Word e presentazioni di PowerPoint) archiviati in OneDrive e SharePoint.

Nota: quando utilizzi la ricerca federata o i connettori federati, la stringa di query viene inviata a tutti i backend di ricerca di terze parti abilitati. La stringa di query inviata a un sistema di terze parti potrebbe contenere parti dei dati nella tua richiesta di ricerca e nella cronologia delle conversazioni. Il sistema di terze parti può collegare la query alla tua identità. Una volta che i dati sono nel sistema di terze parti, sono soggetti ai Termini di servizio e alle norme sulla privacy di quel sistema, non ai Termini di servizio di Google Cloud.

Versioni di Microsoft Outlook supportate

Il datastore Microsoft Outlook supporta l'API Microsoft Graph v1.0 con l'integrazione IDP.

Azioni supportate

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

Azione	Descrizione
Crea contatto	Crea un nuovo contatto in Microsoft Outlook.
Creazione evento	Crea un nuovo evento.
Download degli allegati	Scarica un allegato da un'email di Microsoft Outlook.
Invia email	Invia un'email. Ciò include l'invio di email con allegati.
Aggiungi allegati	Aggiunge uno o più allegati a una bozza di email esistente.
Creazione di un messaggio	Crea una nuova bozza di email nella casella di posta dell'utente che ha eseguito l'accesso.
Inoltra posta	Inoltra un'email esistente a uno o più destinatari.
Sposta posta	Sposta un'email in un'altra cartella della posta nella casella di posta dell'utente che ha eseguito l'accesso.
Rispondi al messaggio	Invia una risposta a un'email esistente nella casella di posta dell'utente che ha eseguito l'accesso.
Aggiorna messaggio	Aggiorna una bozza di email esistente nella casella di posta dell'utente che ha eseguito l'accesso.
Aggiorna contatto	Aggiorna un contatto esistente in Microsoft Outlook.
Aggiorna evento	Aggiorna un evento esistente.
Leggi i dati di Excel	Elenca le cartelle di lavoro, legge i fogli di lavoro, le tabelle e le righe dai file Excel (.xlsx) archiviati in OneDrive o SharePoint.
Modifica i dati di Excel	Aggiunge e aggiorna righe, crea fogli di lavoro e tabelle e aggiunge colonne chiave nei file Excel (.xlsx) archiviati in OneDrive o SharePoint.
Crea documento Word	Crea un nuovo documento Word (.docx) in OneDrive dell'utente.
Converti un documento Word in PDF	Converte in PDF un documento Word (.docx) archiviato in OneDrive o SharePoint.
Crea una presentazione PowerPoint	Crea una nuova presentazione PowerPoint (.pptx) in OneDrive dell'utente.
Converti PowerPoint in PDF	Converte in PDF una presentazione PowerPoint (.pptx) archiviata in OneDrive o SharePoint.
Crea calendario	Crea un nuovo calendario per l'utente che ha eseguito l'accesso.
Aggiorna calendario	Aggiorna un calendario esistente per l'utente che ha eseguito l'accesso.
Invia RSVP all'evento	Risponde (accetta, rifiuta o accetta con riserva) a un invito a un evento nel calendario.

Note:

• Sono disponibili anche altre azioni di sola lettura.
• La dimensione massima dei file per il caricamento e il download in Gemini Enterprise è di 25 MB.
• Le azioni di Excel, Word e PowerPoint richiedono autorizzazioni aggiuntive dell'API Microsoft Graph per i file di OneDrive o SharePoint con cui l'utente sta lavorando. Per maggiori dettagli, consulta [Autorizzazioni richieste](#required-permissions).

Autorizzazioni obbligatorie

La tabella seguente descrive le autorizzazioni necessarie per la ricerca e le azioni di Microsoft Outlook.

Modalità di connessione	Autorizzazione	Purpose
Ricerca federata	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegato) Consente al datastore di leggere la casella di posta dell'utente che ha eseguito l'accesso, le email delle caselle di posta condivise, gli eventi nel calendario e i contatti.
Acquisizione dei dati	Calendars.Read	(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari.
	Calendars.ReadBasic.All	(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari, ad eccezione di proprietà come corpo, allegati ed estensioni.
	Contacts.Read	(Applicazione) Consente al datastore di leggere tutti i contatti in tutte le caselle di posta.
	Mail.Read	(Applicazione) Consente al datastore di leggere la posta in tutte le caselle postali.
	Mail.ReadBasic	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle di posta. Include tutte le proprietà, ad eccezione di body, previewBody, attachments e di eventuali proprietà estese.
	Mail.ReadBasic.All	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle di posta. Include tutte le proprietà, ad eccezione di body, previewBody, attachments e di eventuali proprietà estese.
	User.Read	(Delegato) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso.
	User.Read.All	(Applicazione) Consente al datastore di leggere l'insieme completo di proprietà del profilo, report e gestori di altri utenti della tua organizzazione.
	User.ReadBasic.All	(Applicazione) Consente al datastore di leggere un insieme di base di proprietà del profilo di altri utenti della tua organizzazione.
Azioni	Mail.Send	(Delegato) Consente al datastore di inviare email come utenti dell'organizzazione.
	Mail.ReadWrite	(Delegato) Consente al datastore di creare, leggere, aggiornare, spostare ed eliminare i messaggi e di aggiungere allegati ai messaggi. Obbligatorio per le azioni **Aggiungi allegati**, **Crea messaggio**, **Aggiorna messaggio** e **Sposta posta**.
	Calendars.ReadWrite	(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare eventi nei calendari degli utenti.
	Contacts.ReadWrite	(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare i contatti degli utenti.
	User.Read	(Delegato) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso.
Produttività dei file (Excel, Word, PowerPoint)	Files.Read.All	(Delegato) Sufficiente solo per gli strumenti che leggono i metadati dei file o scaricano i contenuti dei file: elencare i fogli di lavoro Excel, leggere i metadati dei fogli di lavoro Excel e convertire i documenti Word (.docx) o PowerPoint (.pptx) in PDF. Legge tutti i file a cui l'utente può accedere, inclusi i file archiviati nei siti SharePoint a cui l'utente ha accesso. Non sufficiente per le operazioni sui contenuti delle cartelle di lavoro di Excel (vedi la riga successiva).
	Files.ReadWrite.All	(Delegato) Obbligatorio per tutte le operazioni sui contenuti delle cartelle di lavoro di Excel (lettura e scrittura), tra cui recupero di fogli di lavoro, tabelle, righe e singole righe, creazione di fogli di lavoro e tabelle, aggiunta e aggiornamento di righe e aggiunta di colonne chiave. In base al riferimento API Microsoft Graph per questi endpoint (ad esempio, worksheet-list, table-list, tablerow-list), l'autorizzazione delegata accettata è Files.ReadWrite. Files.ReadWrite.All concede la stessa funzionalità su tutti i Drive a cui l'utente può accedere (OneDrive personale e qualsiasi raccolta di documenti di SharePoint a cui l'utente ha accesso). Inoltre, è necessaria per creare documenti Word e PowerPoint in OneDrive dell'utente.
	User.Read	(Delegato) Obbligatorio per risolvere la posizione di OneDrive dell'utente che ha eseguito l'accesso per le operazioni sui file.
Attività (elenchi di cose da fare e attività di Outlook)	Tasks.Read	(Delegata) Obbligatoria per le operazioni di lettura sugli elenchi di attività e sulle attività di Outlook dell'utente che ha eseguito l'accesso (elenco di elenchi di attività, elenco di attività, recupero di attività).
	Tasks.ReadWrite	(Delegato) Obbligatorio per le operazioni di scrittura: creazione, aggiornamento ed eliminazione di attività negli elenchi di attività di Outlook dell'utente che ha eseguito l'accesso.
Utenti e directory (enumerazione delegata)	User.ReadBasic.All	(Delegato) Obbligatorio per gli strumenti che enumerano o cercano i profili di altri utenti dell'organizzazione (Get User, List Users e strumenti che operano sulle caselle di posta o sui calendari di altri utenti).

Nota: le azioni di produttività dei file riportate sopra richiedono che l'amministratore del tenant dell'utente conceda le autorizzazioni API Microsoft Graph corrispondenti alla registrazione dell'app OAuth. Se queste autorizzazioni non vengono concesse, le richieste agli strumenti Excel, Word e PowerPoint non vanno a buon fine e viene visualizzato un errore HTTP 403 accessDenied. Consigliato: concedi Files.ReadWrite.All, che copre tutti gli strumenti di produttività dei file. Se hai bisogno solo della conversione in PDF di Word o PowerPoint e dell'elenco/dei metadati delle cartelle di lavoro di Excel (nessun accesso a fogli di lavoro, tabelle o righe), è sufficiente Files.Read.All. Per le operazioni basate su driveItem (conversione di PDF di Word/PowerPoint, elenco di cartelle di lavoro di Excel, lettura di metadati di cartelle di lavoro di Excel), Microsoft Graph documenta anche Sites.Read.All o Sites.ReadWrite.All come alternative accettate (vedi driveItem-get e driveItem-get-content-format). Per i passaggi di configurazione, consulta Configura Microsoft Outlook e imposta le autorizzazioni necessarie.

Nota: se mancano Tasks.Read o Tasks.ReadWrite, gli strumenti per le attività di Outlook non funzionano e viene visualizzato l'errore HTTP 403 notAllowed. La mancanza di User.ReadBasic.All (delegato) causa l'errore degli strumenti di ricerca degli utenti con HTTP 403 Authorization_RequestDenied. I tenant che richiedono un accesso utente con privilegi più elevati possono sostituire User.ReadBasic.All con User.Read.All o Directory.Read.All.

Per informazioni su come aggiungere le autorizzazioni per Microsoft Outlook, consulta Configura Microsoft Outlook e imposta le autorizzazioni necessarie.

Limiti di frequenza per l'importazione dati

Il limite del volume di richieste è di 10.000 richieste API per un periodo di 10 minuti. Questi limiti di frequenza si applicano esclusivamente al datastore Microsoft Outlook quando scegli di utilizzare l'importazione come modalità di connessione.

Limitazioni

Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore Microsoft Outlook.

• 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 di Microsoft Outlook 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 Microsoft Outlook è supportato solo nelle località global, us e eu.

• Il datastore Microsoft Outlook può elaborare una transazione al secondo per nodo e limita le transazioni che superano questo limite.

• La capacità del datastore Microsoft Outlook di riprovare in caso di errori di superamento del limite di frequenza dipende dalla ricezione di un valore retry-after dall'API Microsoft Graph, che viene fornito solo per il datastore Outlook. Il numero predefinito di nuovi tentativi è tre.

• La velocità effettiva del datastore di Microsoft Outlook è limitata dalle restrizioni sulle chiamate API imposte da Microsoft Graph. I limiti si applicano a ogni combinazione di ID app e casella di posta, ovvero a un'app specifica che accede alla casella di posta di un utente o di un gruppo specifico. Il superamento del limite per una casella di posta non influisce sulla capacità dell'applicazione di accedere a un'altra casella di posta.

• Il datastore Microsoft Outlook viene mappato uno a uno con un singolo ID tenant Azure. Non può estendersi su più tenant Microsoft 365 isolati all'interno di un'organizzazione multi-tenant (MTO). Devi creare un datastore dedicato per ogni tenant distinto.

• 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. I tentativi di eseguire query su queste caselle di posta o su caselle di posta tra tenant possono generare un errore MailboxNotEnabledForRESTAPI.

• Il datastore di Microsoft Outlook può elaborare una transazione al secondo per nodo e limita le transazioni che superano questo limite.

Passaggi successivi

• Per creare e configurare un datastore con Microsoft Outlook, consulta Configura un datastore Microsoft Outlook.