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

Slack

透過 Slack 連接器，您可以對 Slack 資料執行插入、刪除、更新和讀取作業。

事前準備

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

在 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)
  如要瞭解如何啟用服務，請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。
如要瞭解如何建立 Slack 工作區，請參閱「快速入門 Slack」。如需 Slack 平台相關資訊，請參閱 Slack 平台總覽。

設定連接器

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

在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。
前往「Connections」(連線) 頁面
按一下「+ 建立新連線」，開啟「建立連線」頁面。
在「位置」部分中，選擇連線位置。
1. 區域：從下拉式清單中選取位置。
  如需所有支援地區的清單，請參閱「位置」一文。
2. 點按「下一步」。
在「連線詳細資料」部分，完成下列步驟：
1. 連接器：從可用連接器的下拉式清單中選取「Slack」。
2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。
  連線名稱必須符合下列條件：
  - 連線名稱可使用英文字母、數字或連字號。
  - 字母必須為小寫。
  - 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
  - 連結名稱不得超過 49 個字元。
4. 視需要輸入連線執行個體的「Description」(說明)。
5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
6. 服務帳戶：選取具備必要角色的服務帳戶。
7. 視需要設定「連線節點設定」：
  - 節點數量下限：輸入連線節點數量下限。
  - 節點數量上限：輸入連線節點數量上限。
  節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連線器定價的影響，請參閱「連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。
8. (選用) 在「進階設定」專區中，選取「使用 Proxy」核取方塊，為連線設定 Proxy 伺服器，並設定下列值：
9. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
10. 點按「下一步」。
在「Authentication」(驗證) 部分，輸入驗證詳細資料。
1. 選取「驗證類型」，然後輸入相關詳細資料。
  Slack 連線支援下列驗證類型：
  - OAuth2.0 - 授權碼
  - 使用者權杖驗證
2. 點按「下一步」。
檢查：檢查連線和驗證詳細資料。
點選「建立」。

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

OAuth 2.0 - 授權碼
如要使用 OAuth 2.0 進行驗證，請輸入下列詳細資料：
- 用戶端 ID：連接器為您建立的應用程式提供的用戶端 ID。

範圍：以半形逗號分隔的所需範圍清單。

用戶端密鑰：Secret Manager 密鑰，內含您建立的連結應用程式用戶端密鑰。

密鑰版本：上述所選密鑰的密鑰版本。

使用者權杖驗證
如要使用使用者權杖進行驗證，請輸入下列詳細資料：
- 使用者權杖：用於驗證使用者的權杖。
- 密鑰版本：上述所選密鑰的密鑰版本。

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

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

建立連結後採取的其他步驟

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

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

重新授權授權碼

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

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

連線設定範例

本節列出您在建立連線時設定的各個欄位範例值。

Slack - UserToken 驗證連線類型

欄位名稱	詳細資料
位置	us-central1
連接器	Slack
連接器版本	1
連線名稱	slack-usertoken-connection
啟用 Cloud Logging	是
服務帳戶	my-service-account@my-project.iam.gserviceaccount.com
詳細程度	5
節點數量下限	2
節點數量上限	50
使用者權杖驗證	是
使用者權杖	USER_TOKEN
密鑰版本	1

Slack - OAuth 2.0 驗證連線類型

欄位名稱	詳細資料
位置	us-central1
連接器	Slack
連接器版本	1
連線名稱	slack-google-cloud-oauth-conn
啟用 Cloud Logging	是
服務帳戶	my-service-account@my-project.iam.gserviceaccount.com
詳細程度	5
節點數量下限	2
節點數量上限	50
OAuth 2.0 - 授權碼	是
用戶端 ID	CLIENT_ID
範圍	channels:read、groups:read、im:read、mpim:read、channels:write、groups:write、 im:write、mpim:write、channels:history、groups:history、im:history、mpim:history、 search:read、chat:write:user、chat:write:bot、files:read、files:write:user、pins:read、 pins:write、usergroups:read、usergroups:write、reminders:read、reminders:write、 users:read、users.profile:write
用戶端密鑰	CLIENT_SECRET
密鑰版本	2

系統限制

每個節點的 Slack 連接器每秒最多可處理 1 筆交易，超過此限制的交易都會遭到節流。根據預設，整合連接器會為連線分配 2 個節點 (提高可用性)。

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

在整合中運用 Slack 連線

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

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

實體、作業和動作

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

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

動作

本節列出 Slack 連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

InviteUser 動作

這項操作會邀請使用者加入頻道。

InviteUser 動作的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	要邀請使用者加入的公開或私人頻道 ID。
使用者	字串	是	以半形逗號分隔的使用者 ID 清單。最多可指定 30 個使用者 ID。

如需如何設定 InviteUser 動作的範例，請參閱「邀請使用者範例」。

CloseChannel 動作

這項操作會關閉即時訊息或多人即時訊息。

CloseChannel 的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	要關閉的對話 ID。

如需如何設定 CloseChannel 動作的範例，請參閱「CloseChannel Example」。

JoinChannel 動作

使用者可透過這項動作加入現有對話。

JoinChannel 的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	要加入的頻道 ID。

如要瞭解如何設定 JoinChannel 動作，請參閱「JoinChannel 範例」。

LeaveChannel 動作

這項操作可讓使用者離開對話。

LeaveChannel 的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	要離開的對話 ID。

如需如何設定 LeaveChannel 動作的範例，請參閱「LeaveChannel Example」。

OpenChannel 動作

這項操作會開啟或繼續即時訊息或多人即時訊息。

OpenChannel 的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	提供即時訊息或多人即時訊息的 ID，或指定使用者 ID，即可繼續對話。
使用者	字串	是	以半形逗號分隔的使用者清單。如果只指定一位使用者，系統會建立 1:1 即時訊息。如未指定任何使用者，請指定頻道 ID 來繼續對話。

如需如何設定 OpenChannel 動作的範例，請參閱「OpenChannel 範例」。

DownloadFile 動作

這項操作會下載檔案。

DownloadFile 的輸入參數

參數名稱	資料類型	接受輸出串流	說明
FileId	字串	否	要下載的檔案 ID
FileLocation	字串	否	檔案下載位置
FileStream	字串	是	要寫入檔案資料的輸出串流執行個體。如果未指定 FileLocation，系統就會使用這個欄位。
編碼	字串	否	FileData 的編碼類型。您可以指定 BASE64 或 NONE。預設值為 BASE64。

如需如何設定 DownloadFile 動作的範例，請參閱「DownloadFile 範例」。

EndDnd 動作

這項操作會結束使用者的勿擾模式。

EndDnd 動作的輸入參數

傳遞空白 JSON，例如 {}。

如要瞭解如何設定 EndDnd 動作，請參閱「EndDnd Example」。

SetSnooze 動作

這項操作會為使用者開啟勿擾模式或變更持續時間。

SetSnooze 動作的輸入參數

參數名稱	資料類型	必填	說明
NumOfMinutes	字串	60	要將使用者設為暫緩通知的分鐘數。

如要瞭解如何設定 SetSnooze 動作，請參閱「設定暫緩範例」。

EndSnooze 動作

這項操作會結束使用者的暫緩模式。

EndSnooze 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需如何設定 EndSnooze 動作的範例，請參閱「EndSnooze 範例」。

SendScheduleMessage 動作

這項動作會排定傳送訊息至頻道的時程。

SendScheduleMessage 動作的輸入參數

傳遞空白 JSON，例如 {}。

如要瞭解如何設定 SendScheduleMessage 動作，請參閱「傳送排定訊息範例」。

RemoveProfilePhoto 動作

這項操作會移除使用者的個人資料相片。

RemoveProfilePhoto 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需如何設定 RemoveProfilePhoto 動作的範例，請參閱「RemoveProfilePhoto Example」。

SendEphemeralMessage 動作

這項動作會將臨時訊息傳送給頻道中的使用者。

SendEphemeralMessage 動作的輸入參數

傳遞空白 JSON，例如 {}。

如要瞭解如何設定 SendEphemeralMessage 動作的範例，請參閱「傳送暫時性訊息範例」。

GetPermaLink 動作

這項動作會擷取對話或頻道中特定訊息的永久連結網址。

GetPermaLink 動作的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	頻道的專屬 ID。
MessageId	字串	是	訊息的 ID。

如需如何設定 GetPermaLink 動作的範例，請參閱「GetPermaLink 範例」。

SetReadCursor 動作

這項動作會在管道中設定已讀取位置，將特定時間點之前的訊息標示為已讀取。

SetReadCursor 動作的輸入參數

參數名稱	資料類型	必填	說明
ChannelId	字串	是	頻道的專屬 ID。
MessageId	字串	是	訊息的 ID。

如需如何設定 SetReadCursor 動作的範例，請參閱「SetReadCursor 範例」。

GetTeamBillableInfo 動作

這項操作會擷取工作區的帳單詳細資料，包括目前的方案和可計費使用者資訊。

GetTeamBillableInfo 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需如何設定 GetTeamBillableInfo 動作的範例，請參閱「GetTeamBillableInfo 範例」。

EnableUserGroup 動作

這項操作會啟用使用者群組。

EnableUserGroup 動作的輸入參數

參數名稱	資料類型	必填	說明
UserGroup	字串	是	使用者群組的 ID。
TeamId	字串	是	與使用者群組相關聯的團隊 ID。

如需如何設定 EnableUserGroup 動作的範例，請參閱「EnableUserGroup Example」。

停用使用者群組動作

這項操作會停用使用者群組。

DisableUserGroup 動作的輸入參數

參數名稱	資料類型	必填	說明
UserGroup	字串	是	使用者群組的 ID。
TeamId	字串	是	與使用者群組相關聯的團隊 ID。

如需如何設定 DisableUserGroup 動作的範例，請參閱「停用使用者群組範例」。

動作範例

範例 - InviteUser

在 Configure connector task 對話方塊中，按一下 Actions。
選取「InviteUser」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "ChannelId": "C06Q6NTRNA2",
  "Users": "U070MCLRREW"
}
```

如果動作成功，InviteUser 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true"
}]

範例 - CloseChannel

在 Configure connector task 對話方塊中，按一下 Actions。
選取「CloseChannel」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "ChannelId": "C075U92TU4U"
}
```

如果動作成功，CloseChannel 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true"
}]

範例 - JoinChannel

在 Configure connector task 對話方塊中，按一下 Actions。
選取「JoinChannel」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "ChannelId": "C06UMDTL1EH"
}
```

如果動作成功，JoinChannel 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true"
}]

範例 - LeaveChannel

在 Configure connector task 對話方塊中，按一下 Actions。
選取「LeaveChannel」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "ChannelId": "C06UME4PM2R"
}
```

如果動作成功，LeaveChannel 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true"
}]

範例 - OpenChannel

在 Configure connector task 對話方塊中，按一下 Actions。
選取「OpenChannel」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
"Users": "U06VCS3NDNC,U06NE4KAL0G",
"ChannelId": "C071CU9UXFF"
}
```

如果動作成功，OpenChannel 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
[{
"Success": "true"
}]

範例 - DownloadFile

在 Configure connector task 對話方塊中，按一下 Actions。
選取「DownloadFile」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{
  "FileId": "F075UHEMSN8",
  "HasBytes": true
}
```

如果動作成功，DownloadFile 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

[{
  "Success": "True",
  "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
}]

其他事項

將「HasBytes」設為「True」，即可下載其他檔案格式，例如 PDF 或 XLSX，這些格式會以 Base64 編碼格式提供內容。
如要下載 txt 格式的檔案，請將「HasBytes」設為「True」，並以位元組形式下載檔案內容。如要下載檔案的實際內容，請將「HasBytes」設為「False」。

範例 - EndDnd

在 Configure connector task 對話方塊中，按一下 Actions。
選取「EndDnd」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{}
```

如果動作成功，EndDnd 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true"
}]

範例 - SetSnooze

在 Configure connector task 對話方塊中，按一下 Actions。
選取「SetSnooze」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
 {
  "NumOfMinutes": "60"
}
```

如果動作成功，SetSnooze 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
 [{
  "Success": "true",
  "SnoozeEnabled": "true",
  "SnoozeEndTime": "1722842455",
  "SnoozeRemaining": "3600",
  "SnoozeIsIndefinite": "false"
}]

範例 - EndSnooze

在 Configure connector task 對話方塊中，按一下 Actions。
選取「EndSnooze」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
{}
```

如果動作成功，EndSnooze 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
  [{
  "Success": "true",
  "DndEnabled": "true",
  "NextDndStartTime": "1722875400",
  "NextDndEndTime": "1722911400",
  "SnoozeEnabled": "false"
}]

範例 - SendScheduleMessage

在 Configure connector task 對話方塊中，按一下 Actions。
選取「SendScheduleMessage」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
 {
  "Channel": "C07AMLB39JN",
  "PostAt": "2024-08-27 14:15:00.0",
  "Text": "Hello, World!",
  "ReplyBroadCast": false
 }
```

如果動作成功，SendScheduleMessage 工作的回應 connectorOutputPayload 參數會包含類似以下內容的值：

 
   [{
  "Success": "true",
  "ok": "true",
  "scheduled_message_id": "Q07KD4YSG72",
  "channel": "C07AMLB39JN",
  "post_at": "1724768100",
  "message_user": "U071FD3TS8P",
  "message_type": "message",
  "message_bot_id": "B076304QR9V",
  "message_app_id": "A076HCDGHT5",
  "message_text": "Hello, World!",
  "message_team": "T071W04MGV8",
  "message_bot_profile_id": "B076304QR9V",
  "message_bot_profile_deleted": "false",
  "message_bot_profile_name": "Googlecloud_OAuth_Slack",
  "message_bot_profile_updated": "1717513424",
  "message_bot_profile_app_id": "A076HCDGHT5",
  "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
  "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
  "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
  "message_bot_profile_team_id": "T071W04MGV8",
  "message_blocks_type": "rich_text",
  "message_blocks_block_id": "MYA",
  "message_blocks_elements_type": "rich_text_section",
  "message_blocks_elements_elements_type": "text",
  "message_blocks_elements_elements_text": "Hello, World!"
}]

範例 - RemoveProfilePhoto

在 Configure connector task 對話方塊中，按一下 Actions。
選取「RemoveProfilePhoto」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
 {}
```

如果動作成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

[{
  "Success": "true"
 }]

範例 - SendEphemeralMessage

在 Configure connector task 對話方塊中，按一下 Actions。
選取「SendEphemeralMessage」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
```
 {}
```

如果動作成功，連接器工作 connectorOutputPayload 回應參數的值會類似於下列內容：

 
[{
  "Success": "true"
 }]