Gemini Enterprise 的 Microsoft 365 連接器可讓您透過單一連接器,搜尋及處理 Microsoft 365 的資料,包括 SharePoint 網站、OneDrive 檔案、Outlook 郵件、Outlook 日曆、聯絡人和 Microsoft Teams。連接器會透過 Microsoft Graph API 存取所有這些介面。
由於一個連接器就能涵蓋所有 Microsoft 365 介面,因此您不必為 SharePoint、OneDrive、Outlook 和 Teams 建立個別的資料儲存庫。
連接器支援兩種 OAuth 2.0 驗證方式:
- Google代管的 OAuth (預設):連接器會使用 Google 代管的 Microsoft Entra 應用程式。您不必註冊自己的應用程式,也不必提供用戶端 ID 和用戶端密鑰。
- 自備應用程式:註冊自己的 Microsoft Entra 應用程式,並在設定資料儲存庫時提供其租戶 ID、用戶端 ID 和用戶端密鑰。
詳情請參閱「Microsoft 365 設定」。
支援的動作
啟用 Microsoft 365 連接器後,使用者可在 Gemini Enterprise 中使用自然語言指令執行下列操作。動作會依據作用的 Microsoft 365 產品分組,這與您在Google Cloud 控制台中選取動作時的分組方式一致。表格會顯示每項動作是否只讀取資料或也會進行變更,以及所需的委派 Microsoft Graph 權限。如要瞭解如何要求及授予權限,請參閱「權限」。
使用者和群組
| 動作 | 類型 | 說明 | 所需權限 |
|---|---|---|---|
| 新增群組成員 | 寫入 | 將使用者新增為群組成員。 | GroupMember.ReadWrite.All |
| 新增群組擁有者 | 寫入 | 將使用者新增為群組擁有者。 | Group.ReadWrite.All |
| 建立群組 | 寫入 | 建立新的 Microsoft 365 群組。 | Group.ReadWrite.All |
| 取得我的設定檔 | 唯讀 | 擷取已登入使用者的設定檔,包括 Microsoft 帳戶所用的電子郵件地址。 | User.Read |
| 取得使用者個人資料 | 唯讀 | 擷取目錄中某位使用者的個人資料。 | User.ReadBasic.All |
| 取得使用者工作資料夾 | 唯讀 | 擷取使用者的職稱、部門、辦公室、電話號碼、主管和直屬員工。 | User.Read.All |
| 列出群組成員 | 唯讀 | 列出目錄中群組的直屬成員。 | Group.ReadBasic.AllUser.ReadBasic.All |
| 列出群組擁有者 | 唯讀 | 列出目錄中群組的擁有者。 | GroupMember.Read.AllUser.ReadBasic.All |
| 清單群組 | 唯讀 | 依名稱在目錄中尋找群組,並傳回各群組的 ID。 | Group.ReadBasic.All |
| 在目錄中尋找使用者 | 唯讀 | 依名稱或電子郵件地址,在機構目錄中尋找使用者。 | User.ReadBasic.All |
| 更新群組 | 寫入 | 更新群組的名稱、說明或瀏覽權限。 | Group.ReadWrite.All |
SharePoint 和 OneDrive
| 動作 | 類型 | 說明 | 所需權限 |
|---|---|---|---|
| 取得 Excel 範圍 | 唯讀 | 讀取工作表上某個儲存格區塊中的儲存格值,包括表格外的儲存格。 | Files.Read.All |
| 取得 Excel 表格列 | 唯讀 | 讀取 Excel 活頁簿中資料表的一列,以及資料表的欄標題。 | Files.Read.All |
| 取得 Excel 表格列 | 唯讀 | 讀取 Excel 活頁簿中資料表的資料列,以及資料表的欄標題。 | Files.Read.All |
| 列出 Excel 表格 | 唯讀 | 列出 Excel 活頁簿中已設定格式的表格,以及各表格所在的工作表。 | Files.Read.All |
| 取得 Excel 活頁簿屬性 | 唯讀 | 讀取 Excel 活頁簿的檔案屬性:名稱、大小、網址和上次變更者。 | Files.Read.All |
| 取得 Excel 工作表 | 唯讀 | 讀取 Excel 活頁簿中的一個工作表,以及該工作表中的資料範圍。 | Files.Read.All |
| 列出 Excel 工作表 | 唯讀 | 依分頁順序列出 Excel 活頁簿中的工作表。 | Files.Read.All |
| 列出 Excel 活頁簿 | 唯讀 | 在使用者可存取的 OneDrive 和 SharePoint 網站中,尋找 Excel 活頁簿。 | Sites.Read.AllFiles.Read.All |
| 在文件中搜尋 | 寫入 | 簽入文件,解除編輯鎖定,讓其他人可以存取。 | Files.ReadWrite.All |
| 查看文件 | 寫入 | 取出文件,鎖定文件以進行專屬編輯。 | Files.ReadWrite.All |
| 複製檔案 | 寫入 | 將檔案複製到新位置。 | Files.ReadWrite.All |
| 複製資料夾 | 寫入 | 將資料夾複製到新位置。 | Files.ReadWrite.All |
| 建立檔案 | 寫入 | 在資料夾中建立指定名稱的新檔案。絕不會覆寫現有檔案。如要覆寫,請使用「取代檔案內容」。 | Files.ReadWrite.All |
| 建立資料夾 | 寫入 | 在現有資料夾中建立新資料夾。 | Files.ReadWrite.All |
| 建立分享連結 | 寫入 | 建立檔案或資料夾的共用連結。 | Files.ReadWrite.All |
| 捨棄結帳 | 寫入 | 取消文件簽出,並捨棄所有待變更項目。 | Files.ReadWrite.All |
| 依網址取得檔案或資料夾 | 唯讀 | 尋找 SharePoint 或 OneDrive 連結指向的檔案或資料夾,以便讀取或執行操作。 | Files.Read.All |
| 下載檔案內容 | 唯讀 | 下載雲端硬碟中儲存檔案的原始內容。 | Files.Read.All |
| 取得 OneDrive | 唯讀 | 取得已登入使用者的 OneDrive,以便將檔案儲存或列在頂層,並回報儲存空間配額。 | Files.Read.All |
| 列出資料夾內容 | 唯讀 | 列出雲端硬碟資料夾中的檔案和資料夾。 | Files.Read.All |
| 列出檔案權限 | 唯讀 | 列出檔案或資料夾的共用權限設定。 | Files.Read.All |
| 移動檔案 | 寫入 | 將檔案移至其他資料夾。 | Files.ReadWrite.All |
| 移動資料夾 | 寫入 | 將資料夾移至其他上層資料夾。 | Files.ReadWrite.All |
| 變更檔案名稱 | 寫入 | 重新命名檔案。 | Files.ReadWrite.All |
| 重新命名資料夾 | 寫入 | 重新命名資料夾。 | Files.ReadWrite.All |
| 取代檔案內容 | 寫入 | 取代現有檔案的完整內容。如要建立新檔案,請使用「Create file」。 | Files.ReadWrite.All |
| 傳送分享邀請 | 寫入 | 傳送檔案或資料夾的共用邀請。 | Files.ReadWrite.All |
| 更新檔案或資料夾屬性 | 寫入 | 更新檔案或資料夾的屬性 (名稱、說明、上層資料夾)。 | Files.ReadWrite.All |
| 建立 SharePoint 清單 | 寫入 | 在 SharePoint 網站建立新清單。 | Sites.Manage.All |
| 建立清單項目 | 寫入 | 在 SharePoint 清單中建立新項目。 | Sites.ReadWrite.All |
| 建立 SharePoint 頁面 | 寫入 | 在 SharePoint 網站建立新頁面。 | Sites.ReadWrite.All |
| 取得清單項目 | 唯讀 | 擷取 SharePoint 清單的單一資料列,以及其資料欄值。 | Sites.Read.All |
| 取得 SharePoint 頁面內容 | 唯讀 | 擷取 SharePoint 頁面的 HTML 主體。 | Sites.Read.All |
| 列出清單項目 | 唯讀 | 讀取 SharePoint 清單的資料列,以及各列的資料欄值。 | Sites.Read.All |
| 列出 SharePoint 清單 | 唯讀 | 列出網站上的 SharePoint 清單,包括每份清單的 ID 和範本。 | Sites.Read.All |
| 列出 SharePoint 頁面 | 唯讀 | 列出 SharePoint 網站上的頁面,以及各頁面的標題、網址和發布狀態。 | Sites.Read.All |
| 搜尋 SharePoint 和 OneDrive | 唯讀 | 搜尋使用者可存取的 SharePoint 網站、頁面、清單項目和 OneDrive 檔案。 | Sites.Read.AllFiles.Read.All |
| 更新 SharePoint 清單 | 寫入 | 更新 SharePoint 清單的屬性 (名稱、說明)。 | Sites.Manage.All |
| 更新清單項目 | 寫入 | 更新現有 SharePoint 清單項目的欄位。 | Sites.ReadWrite.All |
| 更新 SharePoint 頁面 | 寫入 | 更新 SharePoint 頁面的標題或檔案名稱。 | Sites.ReadWrite.All |
Outlook
| 動作 | 類型 | 說明 | 所需權限 |
|---|---|---|---|
| 新增連結 | 寫入 | 在現有電子郵件訊息或日曆活動中新增檔案附件。 | Mail.ReadWriteCalendars.ReadWrite |
| 建立日曆 | 寫入 | 在使用者的信箱中建立新日曆。 | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| 建立聯絡人 | 寫入 | 在使用者的「聯絡人」資料夾中建立新聯絡人。 | Contacts.ReadWrite |
| 建立訊息草稿 | 寫入 | 在使用者的信箱中建立電子郵件訊息草稿。 | Mail.ReadWriteMail.ReadWrite.Shared |
| 建立日曆活動 | 寫入 | 在使用者日曆上建立新活動。 | Calendars.ReadWrite |
| 建立回覆草稿 | 寫入 | 建立回覆草稿,傳送給現有電子郵件訊息的寄件者。 | Mail.ReadWriteMail.ReadWrite.Shared |
| 尋找會議時間 | 唯讀 | 根據與會者有空的時間建議會議時間。 | Calendars.Read.Shared |
| 轉寄訊息 | 寫入 | 將現有電子郵件訊息轉寄給指定收件者。 | Mail.Send |
| 取得電子郵件訊息附件 | 唯讀 | 從使用者信箱中的郵件擷取一個檔案附件的位元組。 | Mail.Read |
| 取得自動回覆 | 唯讀 | 擷取使用者的 Outlook 自動回覆 (不在辦公室) 設定。 | MailboxSettings.Read |
| 取得日曆活動 | 唯讀 | 從使用者的 Outlook 日曆擷取一項活動,包括與會者回覆和附件 ID。 | Calendars.Read |
| 取得日曆活動附件 | 唯讀 | 從使用者日曆中的活動擷取一個檔案附件的位元組。 | Calendars.Read |
| 取得電子郵件訊息 | 唯讀 | 從使用者的信箱擷取單一郵件。 | Mail.Read |
| 取得排程可用性 | 唯讀 | 擷取使用者、會議室或設備在日期範圍內的有空/忙碌狀態。 | Calendars.Read |
| 列出日曆活動 | 唯讀 | 列出使用者日曆中特定日期範圍內的活動。 | Calendars.Read |
| 列出日曆 | 唯讀 | 列出使用者信箱中的日曆。 | Calendars.Read |
| 列出 Outlook 類別 | 唯讀 | 列出使用者 Outlook 類別清單中的類別 (標籤)。 | MailboxSettings.Read |
| 列出聯絡人 | 唯讀 | 列出或搜尋使用者 Outlook 通訊錄中的聯絡人。 | Contacts.Read |
| 列出收件匣規則 | 唯讀 | 列出使用者的 Outlook 收件匣規則。 | MailboxSettings.Read |
| 列出郵件資料夾 | 唯讀 | 列出使用者信箱中的郵件資料夾。 | Mail.ReadBasic |
| 列出資料夾中的郵件 | 唯讀 | 列出使用者其中一個郵件資料夾 (例如收件匣或寄件備份) 中的郵件。 | Mail.Read |
| 列出或搜尋共用信箱 | 唯讀 | 列出或搜尋使用者有權存取的共用或委派信箱中的郵件。 | Mail.Read.Shared |
| 移動訊息 | 寫入 | 將電子郵件訊息移至其他郵件資料夾。 | Mail.ReadWrite |
| 回覆訊息的所有收件者 | 寫入 | 回覆現有電子郵件訊息、寄件者和所有其他收件者,並將回覆保留在原始對話中。 | Mail.Send |
| 回覆訊息 | 寫入 | 回覆現有電子郵件訊息給寄件者,並將回覆保留在原始會話群組中。 | Mail.Send |
| 回覆活動邀請 | 寫入 | 回覆會議邀請 (接受、暫時接受或拒絕)。 | Calendars.ReadWrite |
| 搜尋電子郵件 | 唯讀 | 依關鍵字搜尋使用者的 Outlook 郵件。 | Mail.Read |
| 搜尋資料夾中的電子郵件 | 唯讀 | 依關鍵字、寄件者或主旨,搜尋使用者其中一個郵件資料夾 (包括「收件匣/帳單」等子資料夾) 中的郵件。 | Mail.Read |
| 搜尋日曆活動 | 唯讀 | 依關鍵字搜尋使用者的 Outlook 日曆活動。 | Calendars.Read |
| 傳送訊息草稿 | 寫入 | 傳送現有的電子郵件訊息草稿。 | Mail.Send |
| 傳送郵件 | 寫入 | 撰寫並傳送新的電子郵件訊息。 | Mail.Send |
| 更新日曆 | 寫入 | 更新現有日曆的屬性 (名稱、顏色或預設狀態)。 | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| 更新聯絡人 | 寫入 | 更新現有聯絡人的屬性。 | Contacts.ReadWrite |
| 更新活動 | 寫入 | 更新現有日曆活動的屬性。 | Calendars.ReadWrite |
| 更新訊息 | 寫入 | 更新現有電子郵件訊息的屬性 (例如標示為已讀、變更標記或重要性)。 | Mail.ReadWrite |
| 列出工作清單 | 唯讀 | 列出使用者的 Microsoft To Do (Outlook Tasks) 工作清單。 | Tasks.Read |
| 列出工作 | 唯讀 | 列出使用者其中一份 Microsoft To Do (Outlook Tasks) 清單中的工作。 | Tasks.Read |
團隊
| 動作 | 類型 | 說明 | 所需權限 |
|---|---|---|---|
| 將成員新增至頻道 | 寫入 | 將使用者加入私人或共用 Teams 頻道。 | ChannelMember.ReadWrite.All |
| 建立管道 | 寫入 | 在 Teams 團隊中建立新頻道。 | Channel.Create |
| 建立即時通訊 | 寫入 | 建立新的 Teams 聊天 (一對一、群組或會議聊天)。 | Chat.Create |
| 建立會議 | 寫入 | 建立新的 Teams 線上會議。 | OnlineMeetings.ReadWrite |
| 建立排程群組 | 寫入 | 在 Teams 時間表中建立排班群組。 | Schedule.ReadWrite.All |
| 建立休假項目 | 寫入 | 在 Teams 時間表中為使用者建立休假項目。 | Schedule.ReadWrite.All |
| 建立休假原因 | 寫入 | 為 Teams 時間表建立新的請假原因 (例如休假、病假)。 | Schedule.ReadWrite.All |
| 取得時間表 | 唯讀 | 讀取團隊的 Shifts 排班設定和佈建狀態。 | Schedule.Read.All |
| 列出頻道成員 | 唯讀 | 列出 Teams 頻道的成員及其角色。 | ChannelMember.Read.All |
| 列出頻道訊息 | 唯讀 | 列出 Teams 頻道中的訊息。 | ChannelMessage.Read.AllGroup.ReadBasic.All |
| 列出管道 | 唯讀 | 列出 Microsoft Teams 中的頻道。 | Channel.ReadBasic.AllGroup.ReadBasic.All |
| 列出即時通訊訊息 | 唯讀 | 列出 Teams 聊天中的訊息。 | Chat.Read |
| 列出對話 | 唯讀 | 列出使用者參與的 Teams 聊天。 | Chat.ReadBasic |
| 列出已加入的團隊 | 唯讀 | 列出使用者所屬的 Microsoft Teams。 | Team.ReadBasic.All |
| 列出頻道訊息回覆 | 唯讀 | 讀取 Teams 頻道討論串:第一則貼文和下方的回覆。 | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| 列出排程群組 | 唯讀 | 列出團隊「輪班」時間表中的排班群組。 | Schedule.Read.All |
| 列出休假項目 | 唯讀 | 列出團隊「輪班」時間表中預訂的休假時間。 | Schedule.Read.All |
| 列出休假原因 | 唯讀 | 列出團隊「輪班」時間表上可選取的請假原因。 | Schedule.Read.All |
| 回覆頻道訊息 | 寫入 | 回覆 Teams 頻道中的訊息。 | ChannelMessage.Send |
| 搜尋即時通訊的訊息 | 唯讀 | 搜尋使用者可存取的 Teams 聊天和頻道訊息。 | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| 傳送頻道訊息 | 寫入 | 在 Teams 頻道中張貼訊息。 | ChannelMessage.Send |
| 傳送即時通訊訊息 | 寫入 | 在 Teams 即時通訊中傳送訊息。 | ChatMessage.Send |
| 更新版本 | 寫入 | 更新 Teams 頻道的名稱或說明。 | ChannelSettings.ReadWrite.All |
| 更新頻道訊息 | 寫入 | 編輯先前發布的頻道訊息。 | ChannelMessage.ReadWrite |
| 更新對話 | 寫入 | 更新 Teams 群組通訊的主題。 | Chat.ReadWrite |
| 更新即時通訊訊息 | 寫入 | 編輯先前傳送的即時通訊訊息。 | Chat.ReadWrite |
| 更新排程群組 | 寫入 | 更新排程群組的名稱、啟用狀態或成員。 | Schedule.ReadWrite.All |
| 更新團隊 | 寫入 | 更新 Teams 團隊的名稱、說明或瀏覽權限。 | TeamSettings.ReadWrite.All |
| 更新休假項目 | 寫入 | 更新現有的休假項目。 | Schedule.ReadWrite.All |
權限
上表的「必要權限」欄列出了每項動作所需的委派 Microsoft Graph 權限。Gemini Enterprise 只會要求您啟用動作所需的權限,以及下列每項連結都會要求的權限:
User.Read:讀取已登入使用者的個人資料,藉此識別連接器代表的帳戶。offline_access:讓連接器重新整理存取權杖,不必要求使用者再次登入。
所有權限皆為委派:連接器會以登入使用者的身分運作,且只能存取該使用者有權存取的資料。
如果使用 Google管理的 OAuth,使用者在授權連接器時會同意這些權限;部分權限則需要 Microsoft Entra 管理員代表組織同意。如果是自己的應用程式,請在註冊時授予這些權限。詳情請參閱「設定 Microsoft API 權限」。
限制
本節概述可能影響您使用 Microsoft 365 資料儲存庫的已知問題和限制。
- 建立新應用程式或在現有應用程式中新增資料儲存庫時,建議只將一個資料儲存庫與單一連接器類型的動作建立關聯。
- 不支援對現有 Microsoft 365 資料儲存庫強制執行 VPC Service Controls 範圍。如要強制執行 VPC Service Controls,請刪除並重新建立資料儲存庫。如要進一步瞭解 VPC Service Controls,以及如何在啟用 VPC Service Controls 後使用動作,請參閱「使用 VPC Service Controls 保護應用程式」。
- Microsoft 365 資料儲存庫僅支援
global、us和eu位置。
Microsoft 365 資料儲存庫與單一 Microsoft 365 租戶一對一對應。無法跨越多租戶組織 (MTO) 內的多個獨立租戶。您必須為每個不同的租戶建立專屬資料儲存庫。
Google代管的 OAuth 僅支援商業 Microsoft 雲端 (包括 GCC) 中的租戶,不支援靜態 IP 輸出。如果是 GCC High 或 DoD 租用戶,或要使用靜態 IP 輸出,請使用自己的 Microsoft Entra 應用程式。
信箱必須完全遷移至 Exchange Online。在混合式 Exchange 環境中,託管於地端部署的信箱無法透過 Microsoft Graph API 存取,查詢這些信箱可能會傳回
MailboxNotEnabledForRESTAPI錯誤。
後續步驟
如要使用 Microsoft 365 建立及設定資料儲存庫,請參閱「設定 Microsoft 365 資料儲存庫」。
如要設定連接器驗證時使用的 Microsoft Entra 應用程式,請參閱「Microsoft 365 設定」。
如要查看及管理已啟用的動作,請參閱「管理動作」。