本頁面由 Cloud Translation API 翻譯而成。

Microsoft Teams

Microsoft Teams 連接器可連線至 Microsoft Teams 應用程式。

事前準備

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

在 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)
  如要瞭解如何啟用服務，請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。

設定連接器

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

在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。
前往「連線」頁面
按一下「+ 建立新連線」，開啟「建立連線」頁面。
在「位置」部分中，選擇連線位置。
1. 區域：從下拉式清單中選取位置。
  如需所有支援的地區清單，請參閱「位置」一文。
2. 點選「下一步」。

在「連線詳細資料」部分，完成下列步驟：

連接器：從可用連接器的下拉式清單中選取「Microsoft Teams」。
連接器版本：從可用版本的下拉式清單中選取連接器版本。
在「連線名稱」欄位中，輸入連線執行個體的名稱。
連線名稱必須符合下列條件：
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
- 連結名稱長度不得超過 63 個字元。
視需要輸入連線執行個體的「Description」(說明)。
服務帳戶：選取具備必要角色的服務帳戶。
輸入連線執行個體的 Azure 租戶。
(選用) 選取「包含所有群組」，將貴機構的所有群組納入規則
視需要設定「連線節點設定」：
- 節點數量下限：輸入連線節點數量下限。
- 節點數量上限：輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連接器定價的影響，請參閱「連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

SSL 設定：從信任模型中選取「Public(Default)」。
點選「下一步」。
在「驗證」部分中，完成下列步驟：
1. 用戶端 ID：用於要求存取權杖的用戶端 ID。
2. 範圍：以半形逗號分隔的所需範圍清單
3. 用戶端密鑰：Secret Manager 密鑰，內含您建立的已連結應用程式用戶端密鑰。
4. 密鑰版本：內含用戶端密鑰的密鑰版本。
5. 授權網址：建立 OAuth 用戶端時產生的授權網址。請按照下列格式輸入網址：https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent。例如 https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent。
6. 點選「下一步」。
檢查：檢查連線和驗證詳細資料。
點選「建立」。

如果是 Authorization code 驗證類型，建立連線後，您必須執行幾個額外步驟來設定驗證。詳情請參閱建立連結後需執行的額外步驟。

注意：如果您使用 Authorization code 驗證類型，且已在應用程式中進行任何設定變更，則必須重新授權 Microsoft Teams 連線。如要瞭解如何重新授權，請參閱「授權碼的重新授權」。

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

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

在「連線」頁面中，找出新建立的連線。
請注意，新連接器的「狀態」會顯示「需要授權」。
按一下「需要授權」。
系統隨即會顯示「編輯授權」窗格。
將「重新導向 URI」值複製到外部應用程式。
驗證授權詳細資料。
按一下「Authorize」。
授權成功後，「連線」頁面的連線狀態會設為「有效」。

重新授權授權碼

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

在「連線」頁面中，按一下所需連線。
系統隨即會開啟連線詳細資料頁面。
按一下「編輯」即可編輯連結詳細資料。
在「驗證」部分中，確認「OAuth 2.0 - 授權碼」詳細資料。
視需要進行必要變更。
按一下 [儲存]。系統會將您帶往連線詳細資料頁面。
在「驗證」部分中，按一下「編輯授權」。系統會顯示「Authorize」(授權) 窗格。
按一下「Authorize」。
如果授權成功，「連線」頁面的連線狀態會設為「有效」。

系統限制

Microsoft Teams 連接器每分鐘最多可處理 30 筆交易，每個節點最多可處理 Team Members, Times Off, Channels, and Chats 實體的清單作業，超過此限制的交易會遭到節流。

根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

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

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。
不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。
作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
- 列出
- 取得
- 建立
- 更新
- 刪除
從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。
動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作範例

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

範例 - 動作

這個範例會將訊息傳送至特定Chat實體。

在「Configure connector task」對話方塊中，按一下 Actions。
從 Actions 清單中選取 SendMessage。
選取「Actions」作業，然後按一下「完成」。

在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

      {
        "TeamId": "cc110f3f-3088-4b4c-b965-e1f3e0a2dfab",
        "ChannelId": "19%3a7680178ef3ab4b1eb762a7078b990083%40thread.tacv2",
        "Content": "Hello Guys Lets play"
      }

實體作業範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有記錄

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

在「Configure connector task」對話方塊中，按一下 Entities。
從 Entity 清單中選取 Channel Members。
選取「List」作業，然後按一下「完成」。
(選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。請一律在單引號 (') 內指定篩選子句值。例如 Id='13b1724a91ce448bad2f1986321fc70f'。您也可以使用邏輯運算子指定多個篩選條件。例如：Id='13b1724a91ce448bad2f1986321fc70f' and Inactive=false。

範例 - 取得記錄

這個範例會從 Chats 實體取得具有指定 ID 的記錄。

在「Configure connector task」對話方塊中，按一下 Entities。
從 Entity 清單中選取 Chats。
選取「Get」作業，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入) 區段中，按一下「EntityId」，然後在「Default Value」(預設值) 欄位中輸入 19:1956432abc05491bb26f51f9f7263020@thread.v2。
其中 19:1956432abc05491bb26f51f9f7263020@thread.v2 是 Chats 實體中的主鍵值。

範例 - 建立記錄

這個範例會在 Group Owners 實體中建立記錄。

在「Configure connector task」對話方塊中，按一下 Entities。
從 Entity 清單中選取 Group Owners。
選取「Create」作業，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "GroupId": "1356c566-d799-4d49-86c0-b09ab6afdb47",
  "MemberId": "caf19b29-3af1-4191-b455-16468e6aba4b"
}
```
如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：
```
{
"Id": "c3c68bc9a1343242443ca8e5ddcaa0000"
}
```

範例 - 更新記錄

這個範例會更新 Teams 實體中具有指定 ID 的記錄。

在「Configure connector task」對話方塊中，按一下 Entities。
從 Entity 清單中選取 Teams。
選取「Update」作業，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
      "displayName": "My Team Name Changed",
      "description": "Changed the description for my team"
    }
```
按一下「filterClause」，然後在「Default Value」欄位中輸入 id = '953933bc-1024-4ce7-84dc-bae7f24dc2ca'。

範例 - 刪除記錄

這個範例會刪除 Group Owners 實體中具有指定 ID 的記錄。

在「Configure connector task」對話方塊中，按一下 Entities。
從 Entity 清單中選取 Group Owners。
選取「Delete」作業，然後按一下「完成」。

注意： 如果實體有複合主鍵，您可以指定篩選子句。例如：

GroupId='cc110f3f-3088-4b4c-b965-e1f3e0a2dfab' AND
      OwnerId='c2e29127-839a-49b5-bd15-a592be4a997e'

。

使用 Terraform 建立連線

您可以使用 Terraform 資源建立新連線。

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

如要查看用於建立連線的 Terraform 範本範例，請參閱範本範例。

使用 Terraform 建立這項連線時，您必須在 Terraform 設定檔中設定下列變數：

參數名稱	資料類型	必填	說明
default_queue_name	STRING	否	預設佇列的名稱，執行動作時可能會覆寫。
default_topic_name	STRING	否	預設主題的名稱，執行動作時可能會覆寫。
值區	STRING	是	專案中 tibjms.jar 所在的值區名稱。
物件 ID	STRING	是	值區內的 .jar 檔案名稱。

在整合服務中使用 Microsoft Teams 連線

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

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

向 Google Cloud 社群尋求協助

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

後續步驟

瞭解如何暫停及恢復連線。
瞭解如何監控連結器用量。
瞭解如何查看連接器記錄。