總覽

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.All
User.ReadBasic.All
列出群組擁有者 唯讀 列出目錄中群組的擁有者。 GroupMember.Read.All
User.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.All
Files.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.All
Files.Read.All
更新 SharePoint 清單 寫入 更新 SharePoint 清單的屬性 (名稱、說明)。 Sites.Manage.All
更新清單項目 寫入 更新現有 SharePoint 清單項目的欄位。 Sites.ReadWrite.All
更新 SharePoint 頁面 寫入 更新 SharePoint 頁面的標題或檔案名稱。 Sites.ReadWrite.All

Outlook

動作 類型 說明 所需權限
新增連結 寫入 在現有電子郵件訊息或日曆活動中新增檔案附件。 Mail.ReadWrite
Calendars.ReadWrite
建立日曆 寫入 在使用者的信箱中建立新日曆。 Calendars.ReadWrite
Calendars.ReadWrite.Shared
建立聯絡人 寫入 在使用者的「聯絡人」資料夾中建立新聯絡人。 Contacts.ReadWrite
建立訊息草稿 寫入 在使用者的信箱中建立電子郵件訊息草稿。 Mail.ReadWrite
Mail.ReadWrite.Shared
建立日曆活動 寫入 在使用者日曆上建立新活動。 Calendars.ReadWrite
建立回覆草稿 寫入 建立回覆草稿,傳送給現有電子郵件訊息的寄件者。 Mail.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
列出管道 唯讀 列出 Microsoft Teams 中的頻道。 Channel.ReadBasic.All
Group.ReadBasic.All
列出即時通訊訊息 唯讀 列出 Teams 聊天中的訊息。 Chat.Read
列出對話 唯讀 列出使用者參與的 Teams 聊天。 Chat.ReadBasic
列出已加入的團隊 唯讀 列出使用者所屬的 Microsoft Teams。 Team.ReadBasic.All
列出頻道訊息回覆 唯讀 讀取 Teams 頻道討論串:第一則貼文和下方的回覆。 Chat.Read
ChannelMessage.Read.All
Group.ReadBasic.All
列出排程群組 唯讀 列出團隊「輪班」時間表中的排班群組。 Schedule.Read.All
列出休假項目 唯讀 列出團隊「輪班」時間表中預訂的休假時間。 Schedule.Read.All
列出休假原因 唯讀 列出團隊「輪班」時間表上可選取的請假原因。 Schedule.Read.All
回覆頻道訊息 寫入 回覆 Teams 頻道中的訊息。 ChannelMessage.Send
搜尋即時通訊的訊息 唯讀 搜尋使用者可存取的 Teams 聊天和頻道訊息。 Chat.Read
ChannelMessage.Read.All
Group.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 錯誤。

後續步驟