Microsoft Exchange 連接器

透過 Microsoft Exchange 連接器，您可以在 Exchange Web 服務 (EWS) 和 Microsoft Graph 結構定義中，對資料表執行插入、刪除、更新和讀取作業。

支援的版本

這個連接器支援 Exchange Online。

事前準備

使用 Microsoft Exchange 連接器前，請先完成下列工作：

  • 在 Google Cloud 專案中：
    • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
    • 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
    • 將下列 IAM 角色授予要用於連接器的服務帳戶：
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。連接器和服務帳戶必須屬於同一個專案。詳情請參閱「建立服務帳戶」。

    • 啟用下列服務：
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      如要瞭解如何啟用服務，請參閱「啟用服務」。

    如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。

設定連接器

連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

  1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

    前往「Connections」(連線) 頁面

  2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
  3. 在「位置」部分中，選擇連線位置。
    1. 區域：從下拉式清單中選取位置。

      如需所有支援的地區清單，請參閱「位置」一文。

    2. 點按「下一步」。
  4. 在「連線詳細資料」部分，完成下列步驟：
    1. 連接器：從可用連接器的下拉式清單中選取「Microsoft Exchange」。
    2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
    4. 視需要輸入連線執行個體的「Description」(說明)。
    5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
    6. 服務帳戶：選取具備必要角色的服務帳戶。
    7. 視需要設定「連線節點設定」：

      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連線器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

    8. Azure 租戶：用來存取資料的 Microsoft Online 租戶。如未指定租戶，系統會使用預設租戶。
    9. 結構定義：選取 EWS 或 MSGraph 結構定義。預設結構定義為 EWS。
    10. 您可以選取「停用伺服器端篩選」，停用伺服器端篩選功能。
    11. 點按「下一步」。
  5. 在「目的地」部分，選取「主機位址」做為目的地類型，並指定連接器連線的 Exchange 伺服器位址，例如 https://outlook.office365.com/EWS/Exchange.asmx。
  6. 點按「下一步」。
  7. 在「Authentication」(驗證) 部分，輸入驗證詳細資料。 如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

  8. 點選「下一步」。
  9. 檢查：檢查連線和驗證詳細資料。
  10. 點選「建立」。

設定驗證機制

根據使用者名稱和密碼驗證輸入詳細資料

  • 使用者名稱：連接器的使用者名稱。
  • 密碼：Secret Manager 密鑰，內含與連接器相關聯的密碼。

根據 OAuth 2.0 - 授權碼驗證輸入詳細資料

  • 用戶端 ID：用於要求存取權杖的用戶端 ID。
  • 範圍：以半形逗號分隔的所需範圍清單。
  • 用戶端密鑰：用於要求存取權杖的用戶端密鑰。
  • 授權網址：建立 OAuth 用戶端時產生的授權網址。 請按照下列格式輸入網址：https://login.microsoftonline.com/TENANT_IDENTIFIER;/oauth2/v2.0/authorize?prompt=consent。 例如 https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent。

建立連結後需執行的其他步驟

如果您選取 OAuth 2.0 - Authorization code 進行驗證，建立連線後必須執行下列額外步驟：

  1. 在「連線」頁面中，找出新建立的連線。

    請注意，新連接器的「狀態」會顯示「需要授權」。

  2. 按一下「需要授權」。

    系統隨即會顯示「Edit authorization」(編輯授權) 窗格。

  3. 將「重新導向 URI」值複製到外部應用程式。
  4. 驗證授權詳細資料。
  5. 按一下「Authorize」。

    授權成功後，「連線」頁面的連線狀態會設為「有效」。

重新授權授權碼

如果您使用 Authorization code 驗證類型，且已在 Azure Synapse 應用程式中進行任何設定變更，則必須重新授權 Azure Synapse 連線。如要重新授權連結，請按照下列步驟操作：

  1. 在「連線」頁面中，按一下所需連線。

    系統隨即會開啟連線詳細資料頁面。

  2. 按一下「編輯」即可編輯連結詳細資料。
  3. 在「驗證」部分中，驗證「OAuth 2.0 - 授權碼」詳細資料。

    視需要進行變更。

  4. 按一下 [儲存]。系統會將您帶往連線詳細資料頁面。
  5. 在「驗證」部分中，按一下「編輯授權」。系統會顯示「Authorize」(授權) 窗格。
  6. 按一下「Authorize」。

    如果授權成功，「連線」頁面的連線狀態會設為「有效」。

系統限制

Microsoft Exchange 連接器每秒可處理 4 筆交易，每個節點也是如此，超出此限制的交易都會遭到節流。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

在整合中建立 Microsoft Exchange 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連線器」工作使用連線。

  • 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
  • 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。

動作

Microsoft Exchange 連接器提供 actions，例如 MoveItem 和 SendItem。如要瞭解如何設定動作，請參閱「動作範例」。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - MoveItem

  1. 在「Configure connector task」對話方塊中，按一下 Actions。
  2. 選取 MoveItem 動作，然後按一下「完成」。
  3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
     {
  "ItemId":"The unique ItemId of the item to be sent"
  "ItemChangekey":"The unique ItemChangeKey of the item to be sent"
  "FolderDisplayName":"The display name of the new folder"
  }

實體作業範例

範例 - 列出所有 SentItems

這個範例會列出 SentItems 實體中的所有記錄。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取「SentItems」。
  3. 選取「LIST」作業，然後按一下「完成」。

範例 - 從 Sentitems 實體取得特定記錄

這個範例會從 SentItems 實體取得 Id 為「568ea947-e03d-ef11-8409-7c1e5217e912」的記錄。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 SentItems。
  3. 選取「GET」作業，然後按一下「完成」。
  4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 568ea947-e03d-ef11-8409-7c1e5217e912。

    其中 Id 是 SentItems 實體的主鍵值。

  5. 按一下 [完成]。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟