Microsoft Outlook 設定

本頁說明如何在建立 Outlook 資料儲存庫前，設定第三方設定。

設定驗證和權限

您必須在 Microsoft Entra 系統管理中心設定驗證和權限。這是連接器存取及同步處理資料的關鍵。

為 Microsoft Outlook 連接器註冊 Entra 應用程式

在 Gemini Enterprise 建立 Microsoft Outlook 連接器前，請先註冊 Microsoft Entra 應用程式，以便安全存取。

如要在 Entra 中將 Gemini Enterprise 註冊為 OAuth 2.0 應用程式，請按照下列步驟操作：

  1. 前往 Microsoft Entra 系統管理中心。
  2. 在導覽選單中展開「Entra ID」，然後選取「App registrations」(應用程式註冊)。
  3. 在「App registrations」(應用程式註冊) 頁面中，按一下 「New registration」(新增註冊)。

  4. 在「Register an application」(註冊應用程式) 頁面中，執行下列操作：

    1. 在「Name」(名稱) 欄位中，輸入應用程式名稱。
    2. 在「Supported account types」(支援的帳戶類型) 專區，選取「Accounts in this organizational directory only」(僅限這個組織目錄中的帳戶)。
    3. 在「Redirect URI」(重新導向 URI) 部分執行下列操作：
      1. 在平台清單中選取「Web」。
      2. 在重新導向 URI 欄位中，輸入 https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html。
        1. 按一下「Register」。Microsoft Entra 會建立應用程式，並顯示應用程式的總覽頁面。

  5. 在應用程式導覽選單中，按一下「Authentication」。

  6. 按一下「 Add redirect URI」(新增重新導向 URI)。

  7. 在平台選取窗格中，執行下列操作：

    1. 選取「Web」。
    2. 在「Redirect URI」(重新導向 URI) 欄位中，輸入 https://vertexaisearch.cloud.google.com/oauth-redirect。
    3. 按一下 [設定]。

新增資料擷取的聯合憑證

如果您使用「Data ingestion」(資料擷取) 做為連線模式，並使用「Federated credentials」(聯合憑證) 做為驗證方式，請執行下列操作：

  1. 在應用程式導覽選單中，按一下「Certificates & secrets」。
  2. 選取「Federated credentials」分頁標籤。
  3. 按一下「 Add credential」(新增憑證)。
  4. 從「Federated credential scenario」(聯合憑證情境) 清單中，選取「Other issuer」(其他核發者)。
  5. 在「Issuer」(核發者) 欄位中，輸入 https://accounts.google.com。
  6. 在「Subject identifier」(主體 ID) 欄位中，輸入從Google Cloud 控制台取得的值。這個值是在資料部分的建立 Microsoft Outlook 資料儲存庫期間產生。
  7. 在「Name」(名稱) 欄位中，輸入聯合憑證的專屬標籤。
  8. 點按「Add」(新增) 授予存取權。

建立 OAuth 2.0 設定

如要使用 OAuth 2.0 驗證方式建立連線，您必須從 Microsoft Entra 應用程式註冊頁面取得用戶端 ID、用戶端密鑰和租戶 ID。

取得用戶端 ID 和用戶端密鑰

  1. 如要取得用戶端 ID，請按照下列步驟操作：

    1. 在應用程式導覽選單中，選取「總覽」。
    2. 複製「應用程式 (用戶端) ID」。

  2. 如要取得應用程式的用戶端密鑰，請按照下列步驟操作：

    1. 在應用程式導覽選單中，選取「Certificates & secrets」。
    2. 按一下「 New client secret」(新增用戶端密鑰)。
    3. 在用戶端密鑰窗格中，執行下列操作：
      1. 在「Description」(說明) 欄位中輸入 Secret 的說明。
      2. 在「Expires」(到期時間) 清單中，選取到期時間長度。
      3. 按一下「新增」。
    4. 複製「Value」(值) 欄中的用戶端密鑰。

取得租戶 ID

您可以在 Microsoft Entra 系統管理中心的「Overview」(總覽) 頁面，找到「Tenant ID」(租戶 ID) 方塊中的租戶 ID。

設定 Microsoft API 權限

如要為應用程式設定必要的 API 權限，請按照下列步驟操作：

  1. 在應用程式頁面中，選取「API permissions」。

  2. 按一下「Add permissions」。

  3. 在「Request API permissions」頁面中，選取「Microsoft Graph」。

  4. 根據連線模式，搜尋並選取下列權限：

    連線模式 權限 Purpose
    聯合搜尋 Mail.Read
    Mail.Read.Shared
    Calendars.Read
    Contacts.Read    		 (委派) 允許資料儲存庫讀取已登入使用者的信箱、共用信箱中的郵件、日曆活動和聯絡人。
    資料擷取 Calendars.Read (應用程式) 允許資料儲存庫讀取所有日曆的活動。
    Calendars.ReadBasic.All (應用程式) 允許資料儲存庫讀取所有日曆的事件，但內文、附件和擴充功能等屬性除外。
    Contacts.Read (應用程式) 允許資料儲存庫讀取所有信箱中的所有聯絡人。
    Mail.Read (應用程式) 允許資料儲存庫讀取所有信箱中的郵件。
    Mail.ReadBasic (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包含除了 body、previewBody、attachments 和任何擴充屬性以外的所有屬性。
    Mail.ReadBasic.All (應用程式) 允許資料儲存庫讀取所有信箱中的基本郵件屬性。包含除了 body、previewBody、attachments 和任何擴充屬性以外的所有屬性。
    User.Read (委派) 允許資料儲存庫讀取已登入使用者的設定檔。
    User.Read.All (應用程式) 允許資料儲存庫讀取貴機構中其他使用者的完整設定檔屬性、報表和管理員。
    User.ReadBasic.All (應用程式) 允許資料儲存庫讀取貴機構其他使用者的基本設定檔屬性。
    動作 Mail.Send (委派) 允許資料儲存庫以組織使用者的身分傳送郵件。
    Mail.ReadWrite (委派) 執行「新增附件」、「建立郵件」、「更新郵件」和「移動郵件」動作時，必須具備這項權限。
    Calendars.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新及刪除使用者日曆中的活動。
    Contacts.ReadWrite (委派) 允許資料儲存庫建立、讀取、更新及刪除使用者聯絡人。
    User.Read (委派) 允許資料儲存庫讀取已登入使用者的設定檔。
    檔案工作效率 (Excel、Word、PowerPoint) Files.Read.All (委派) 僅適用於讀取檔案中繼資料或下載檔案內容的工具：列出 Excel 活頁簿、讀取 Excel 活頁簿中繼資料，以及將 Word (.docx) 或 PowerPoint (.pptx) 文件轉換為 PDF。不足以執行 Excel 活頁簿內容作業 (請參閱下一列)。
    Files.ReadWrite.All (委派) 所有 Excel 活頁簿內容作業 (讀取和寫入) 都需要這項權限，包括取得工作表、取得表格、取得資料列、取得資料列、建立工作表和表格、新增和更新資料列，以及新增索引鍵資料欄。根據這些端點 (例如 worksheet-list、table-list、tablerow-list) 的 Microsoft Graph API 參考資料，接受的委派權限為 Files.ReadWrite。Files.ReadWrite.All 會針對使用者可存取的所有雲端硬碟，授予相同權限。在使用者 OneDrive 中建立 Word 和 PowerPoint 文件時，也需要這項權限。
    User.Read (委派) 必須解析已登入使用者的 OneDrive 位置，才能執行檔案作業。
    工作 (Outlook 待辦事項清單和工作) Tasks.Read (委派) 必須具備此權限，才能對已登入使用者的 Outlook 工作清單和工作執行讀取作業 (列出工作清單、列出工作、取得工作)。
    Tasks.ReadWrite (委派) 寫入作業的必要權限：在已登入使用者的 Outlook 工作清單中建立、更新及刪除工作。
    使用者和目錄 (委派列舉) User.ReadBasic.All (委派) 適用於列舉或查詢組織中其他使用者設定檔的工具 (取得使用者、列出使用者，以及在其他使用者的信箱或日曆上運作的工具)。

  5. 按一下 [Add Permissions] (新增權限)。

疑難排解

本節說明如何解決 Microsoft Outlook 連接器的常見問題。

排解 REST API 和訊息搜尋問題

如果 Gemini Enterprise 助理回報郵件搜尋功能無法運作，或使用者的信箱未啟用 REST API (對應至 Microsoft Graph 的 MailboxNotEnabledForRESTAPI 錯誤)，您可以在 Microsoft 環境中排解問題。

發生這項錯誤的原因如下：

  • 信箱託管於地端部署環境 (混合式 Exchange 部署)，且未啟用 REST API 存取權。

  • 信箱處於停用或軟刪除狀態。

  • 租戶或目錄不相符。

如要解決這個問題，請確認信箱託管於 Exchange Online，或為混合式信箱設定 REST API 存取權。詳情請參閱 Microsoft 說明文件中的「如何修正 MailboxNotEnabledForRESTAPI」。

使用者在連線時看到「需要管理員核准」

使用者首次從 Gemini Enterprise 網頁應用程式連結至 Microsoft Outlook 時，Microsoft 可能會顯示「Need admin approval」(需要管理員核准) 畫面。如果 Gemini Enterprise 要求管理員層級權限，或 Microsoft Entra 租用戶禁止使用者在未經租用戶管理員同意的情況下授權第三方應用程式，就會發生這種情況。

如要解決這個問題，管理員必須完成首次授權。 之後，租戶中的其他使用者不需經過核准畫面，即可連線。

  1. 請 Microsoft Entra ID 管理員 (須能授予全租戶同意聲明) 登入 Gemini Enterprise 網頁應用程式，並連結至 Microsoft Outlook。

  2. 在權限畫面中，請管理員選取「Consent on behalf of your organization」(代表貴機構同意)，然後按一下「Accept」(接受)。

  3. 請使用者重新連線。

詳情請參閱 Microsoft Entra 說明文件中的「Grant tenant-wide admin consent」(授予全租戶管理員同意聲明)。