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 平台概览。

配置连接器

配置连接器时，您需要创建与数据源（即后端系统）的连接。一个连接需专用于一个数据源。这意味着，如果您有许多数据源，则必须为每个数据源创建单独的连接。如需创建连接，请执行以下步骤：

  1. 在 Cloud 控制台 中，进入 Integration Connectors > 连接页面，然后选择或创建一个 Google Cloud 项目。

    转到“连接”页面

  2. 点击 + 新建以打开创建连接页面。
  3. 在位置部分中，选择连接的位置。
    1. 区域：从下拉列表中选择一个位置。

      如需查看所有受支持区域的列表，请参阅位置。

    2. 点击下一步。
  4. 在连接详情部分中，完成以下操作：
    1. 连接器：从可用连接器的下拉列表中选择 Slack。
    2. 连接器版本：从可用版本的下拉列表中选择一个连接器版本。
    3. 在连接名称字段中，输入连接实例的名称。

      连接名称必须符合以下条件：

      • 连接名称可以使用字母、数字或连字符。
      • 字母必须小写。
      • 连接名称必须以字母开头，以字母或数字结尾。
      • 连接名称不能超过 63 个字符。
    4. （可选）输入连接实例的说明。
    5. 您可以选择启用 Cloud Logging，然后选择日志级别。默认情况下，日志级别设置为 Error。
    6. 服务账号：选择具有所需角色的服务账号。
    7. （可选）配置连接节点设置：

      • 节点数下限：输入连接节点数下限。
      • 节点数上限：输入连接节点数上限。

      节点是处理事务的连接单元（或副本）。 连接处理越多事务就需要越多节点，相反，处理越少事务需要越少节点。 如需了解节点如何影响连接器价格，请参阅连接节点的价格。如果未输入任何值，则默认情况下，节点数下限设置为 2（以便提高可用性），节点数上限设置为 50。

    8. （可选）点击 + 添加标签，以键值对的形式向连接添加标签。
    9. 点击下一步。
  5. 在身份验证部分中，输入身份验证详细信息。
    1. 选择身份验证类型，然后输入相关详细信息。

      Slack 连接支持以下身份验证类型：

      • OAuth2.0 - 授权代码
      • 用户令牌身份验证

      2. 如需了解如何配置这些身份验证类型，请参阅配置身份验证。

    2. 点击下一步。
  6. 查看：查看您的连接和身份验证详细信息。
  7. 点击创建。

配置身份验证

根据您要使用的身份验证输入详细信息。

  • OAuth2.0 - 授权代码

    如需使用 OAuth2.0 进行身份验证，请输入以下详细信息：

    • 客户端 ID：连接器为您创建的应用提供的客户端 ID。
    • 范围：所需范围的逗号分隔列表。
    • 客户端密钥：包含您创建的关联应用的客户端密钥的 Secret Manager 密文。
    • Secret 版本：上方所选 Secret 的 Secret 版本。
  • 用户令牌身份验证

    如需使用用户令牌进行身份验证，请输入以下详细信息：

    • 用户令牌：用于对用户进行身份验证的用户令牌。
    • Secret 版本：上方所选 Secret 的 Secret 版本。

对于 Authorization code 身份验证类型，在创建连接后，您必须执行一些额外的步骤来配置身份验证。如需了解详情，请参阅创建连接后的其他步骤。

创建连接后的其他步骤

如果您选择了 OAuth 2.0 - Authorization code 作为身份验证方式，则必须在创建连接后执行以下额外步骤：

  1. 在“连接”页面中，找到新创建的连接。

    请注意，新连接器的状态将为需要授权。

  2. 点击需要授权。

    系统随即会显示修改授权窗格。

  3. 将重定向 URI 值复制到您的外部应用。
  4. 验证授权详细信息。
  5. 点击 Authorize（授权）。

    如果授权成功，“连接”页面中的连接状态将设为活跃。

重新授权授权代码

如果您使用的是 Authorization code 身份验证类型，并且在应用中进行了任何配置更改，则必须重新授权 Onedrive 连接。如需重新授权关联，请执行以下步骤：

  1. 在“连接”页面中，点击所需的连接。

    系统随即会打开连接详情页面。

  2. 点击修改以修改关联详情。
  3. 在身份验证部分中，验证 OAuth 2.0 - 授权代码详细信息。

    根据需要进行必要的更改。

  4. 点击保存。您随即会进入连接详情页面。
  5. 点击身份验证部分中的修改授权。系统随即会显示 Authorize（授权）窗格。
  6. 点击 Authorize（授权）。

    如果授权成功，“连接”页面中的连接状态将设为活跃。

连接配置示例

本部分列出了您在创建关联时配置的各种字段的示例值。

Slack - UserToken 身份验证连接类型

字段名称 详细信息
位置 us-central1
连接器 Slack
连接器版本 1
连接名称 slack-usertoken-connection
启用 Cloud Logging 是
服务账号 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
详细程度 5
节点数下限 2
节点数上限 50
用户令牌身份验证 是
用户令牌 USER_TOKEN
Secret 版本 1

Slack - OAuth 2.0 身份验证连接类型

字段名称 详细信息
位置 us-central1
连接器 Slack
连接器版本 1
连接名称 slack-google-cloud-oauth-conn
启用 Cloud Logging 是
服务账号 SERVICE_ACCOUNT_NAME@PROJECT_ID.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
Secret 版本 2

系统限制

Slack 连接器每个节点每秒最多可以处理 1 笔交易，并会对超出此限制的所有交易进行节流。默认情况下，Integration Connectors 会为连接分配 2 个节点（以提高可用性）。

如需了解适用于 Integration Connectors 的限制，请参阅限制。

在集成中使用 Slack 连接

创建连接后，该连接将在 Apigee Integration 和 Application Integration 中可用。您可以通过连接器任务在集成中使用该连接。

  • 如需了解如何在 Apigee Integration 中创建和使用连接器任务，请参阅连接器任务。
  • 如需了解如何在 Application Integration 中创建和使用连接器任务，请参阅连接器任务。

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

  • 实体：实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如，在数据库连接器中，表是实体；在文件服务器连接器中，文件夹是实体；在消息传递系统连接器中，队列是实体。

    但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，Entities 列表将为空。

  • 操作：操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作：

    从可用列表中选择一个实体，系统会生成该实体可用的操作列表。如需了解操作的详细说明，请参阅连接器任务的实体操作。不过，如果连接器不支持任何实体操作，则 Operations 列表中不会列出此类不受支持的操作。

  • 动作：动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改，并且动作因连接器而异。通常，操作将具有一些输入参数和一个输出参数。但可能的情况是，连接器不支持任何动作，在这种情况下，Actions 列表将为空。

操作

本部分列出了 Slack 连接器支持的操作。如需了解如何配置操作，请参阅操作示例。

InviteUser 操作

此操作用于邀请用户加入频道。

InviteUser 操作的输入参数

参数名称 数据类型 必填 说明
ChannelId 字符串 True 要邀请用户加入的公开或私享频道的 ID。
Users 字符串 True 以英文逗号分隔的用户 ID 列表。您最多可以指定 30 个用户 ID。

如需有关如何配置 InviteUser 操作的示例，请参阅 InviteUser 示例。

CloseChannel 操作

此操作会关闭私信或多人私信。

CloseChannel 的输入参数

参数名称 数据类型 必填 说明
ChannelId 字符串 True 要关闭的对话的 ID。

如需了解如何配置 CloseChannel 操作，请参阅 CloseChannel 示例。

JoinChannel 操作

此操作可让用户加入现有对话。

JoinChannel 的输入参数

参数名称 数据类型 必填 说明
ChannelId 字符串 True 要加入的频道的 ID。

如需了解如何配置 JoinChannel 操作，请参阅 JoinChannel 示例。

LeaveChannel 操作

此操作允许用户退出对话。

LeaveChannel 的输入参数

参数名称 数据类型 必填 说明
ChannelId 字符串 True 要退出的对话的 ID。

如需了解如何配置 LeaveChannel 操作，请参阅 LeaveChannel 示例。

OpenChannel 操作

此操作会打开或继续私信或多人私信。

OpenChannel 的输入参数

参数名称 数据类型 必填 说明
ChannelId 字符串 True 提供即时消息或多人即时消息的 ID，或指定用户 ID，以继续对话。
Users 字符串 True 用户的逗号分隔列表。如果只指定一位用户，系统会创建一对一私信。如果您未指定任何用户，请指定渠道 ID 以继续对话。

如需了解如何配置 OpenChannel 操作，请参阅 OpenChannel 示例。

DownloadFile 操作

此操作会下载文件。

DownloadFile 的输入参数

参数名称 数据类型 接受输出流 说明
FileId 字符串 错误 要下载的文件的 ID
FileLocation 字符串 错误 要下载文件的位置
FileStream 字符串 True 输出流的实例，用于写入文件数据。如果未指定 FileLocation，则使用此字段。
编码 字符串 错误 FileData 的编码类型。您可以指定 BASE64 或 NONE。默认值为 BASE64。

如需了解如何配置 DownloadFile 操作，请参阅 DownloadFile 示例。

EndDnd 操作

此操作会结束用户的勿扰模式。

EndDnd 操作的输入参数

传递一个空的 JSON，例如 {}。

如需了解如何配置 EndDnd 操作，请参阅 EndDnd 示例。

SetSnooze 操作

此操作会为用户开启勿扰模式或更改其时长。

SetSnooze 操作的输入参数

参数名称 数据类型 必填 说明
NumOfMinutes 字符串 60 用户的延迟分钟数。

如需了解如何配置 SetSnooze 操作，请参阅 SetSnooze 示例。

EndSnooze 操作

此操作会结束用户的暂停模式。

EndSnooze 操作的输入参数

传递一个空的 JSON，例如 {}。

如需了解如何配置 EndSnooze 操作，请参阅 EndSnooze 示例。

SendScheduleMessage 操作

此操作会安排将消息发送到某个渠道。

SendScheduleMessage 操作的输入参数

传递一个空的 JSON，例如 {}。

如需有关如何配置 SendScheduleMessage 操作的示例，请参阅 SendScheduleMessage 示例。

操作示例

示例 - InviteUser

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 InviteUser 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C06Q6NTRNA2",
  "Users": "U070MCLRREW"
}

    4. 如果操作成功，InviteUser 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
 [{
  "Success": "true"
}]

示例 - CloseChannel

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 CloseChannel 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C075U92TU4U"
}

    4. 如果操作成功，CloseChannel 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
 [{
  "Success": "true"
}]

示例 - JoinChannel

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 JoinChannel 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C06UMDTL1EH"
}

    4. 如果操作成功，JoinChannel 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
 [{
  "Success": "true"
}]

示例 - LeaveChannel

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 LeaveChannel 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C06UME4PM2R"
}

    4. 如果操作成功，LeaveChannel 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
 [{
  "Success": "true"
}]

示例 - OpenChannel

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 OpenChannel 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"Users": "U06VCS3NDNC,U06NE4KAL0G",
"ChannelId": "C071CU9UXFF"
}

    4. 如果操作成功，OpenChannel 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
[{
"Success": "true"
}]

示例 - DownloadFile

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 DownloadFile 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "FileId": "F075UHEMSN8",
  "HasBytes": true
}

    4. 如果操作成功，DownloadFile 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

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

其他注意事项

  • 将“HasBytes”设置为“True”以下载其他文件格式（例如 PDF 或 xlsx），这些格式会以 Base 64 编码格式提供内容。
  • 如需下载 txt 格式的文件，请将“HasBytes”设置为“True”，并以字节形式下载文件内容。如需下载文件的实际内容，请将“HasBytes”设置为“False”。

示例 - EndDnd

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 EndDnd 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {}

    4. 如果操作成功，EndDnd 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
 [{
  "Success": "true"
}]

示例 - SetSnooze

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 SetSnooze 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
     {
  "NumOfMinutes": "60"
}

    4. 如果操作成功，SetSnooze 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

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

示例 - EndSnooze

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 EndSnooze 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {}

    4. 如果操作成功，EndSnooze 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

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

示例 - SendScheduleMessage

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 SendScheduleMessage 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
     {
  "Channel": "C07AMLB39JN",
  "PostAt": "2024-08-27 14:15:00.0",
  "Text": "Hello, World!",
  "ReplyBroadCast": false
 }

    4. 如果操作成功，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!"
}]

实体操作示例

本部分介绍如何在此连接器中执行一些实体操作。

示例 - 列出“Messages”实体的记录

此示例列出了 Messages 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Messages。
  3. 选择 List 操作，然后点击完成。

您还可以对以下实体执行列表操作：文件、MessageReplies、Pins、Reactions、Reminders、TeamInfo、UserGroups、Users、Channels、DND、Teams、UserProfile、ScheduledMessages、TeamProfileFields 和 TeamProfileSections。

示例 - 获取“通话”实体的记录

此示例会提取 Calls 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Calls。
  3. 选择 Get 操作，然后点击完成。
  4. 将实体 ID 设置为 R070LKL3YKX，即要传递的键。如需设置实体 ID，请在连接器任务的任务输入部分，点击 EntityId，然后在默认值字段中输入 R070LKL3YKX。

必须直接传递实体 ID 的值。在此示例中，R070LKL3YKX 是唯一的主键值，并会直接传递。

您还可以对以下实体执行 get 操作：通话、MessageReplies、Messages、Reactions、TeamInfo、Reminders、Users 和 Channels

示例 - 删除“通话”实体的记录

此示例会删除 Calls 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Calls。
  3. 选择 Delete 操作，然后点击完成。
  4. 将实体 ID 设置为 R074DSKVDSS，即要传递的键。如需设置实体 ID，请在连接器任务的任务输入部分，点击 EntityId，然后在默认值字段中输入 R074DSKVDSS。

    如果实体有两个复合业务键或主键，您可以将 filterClause 设置为 Id='R074DSKVDSS'。

您还可以对以下实体执行删除操作：文件、MessageReplies、消息、固定内容、回应和提醒。

示例 - 创建“通话”实体的记录

此示例会创建 Calls 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Calls。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
  "JoinURL": "https://example55.com/call"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
  "Id": "R074LBCFBU3"
}

示例 - 创建 Messages 实体的记录

此示例会创建 Messages 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Messages。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C06UF15CB0V",
  "Text": "This is google cloud created Message"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于：

     
{
"Id": "1723008314.867479",
"ChannelId": "C06UF15CB0V"
}

示例 - 创建 Pins 实体的记录

此示例将创建 Pins 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Pins。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"ChannelId": "C06UF15CB0V",
"Id": "1723008314.867479",
"Type": "message"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
"Id": "1723008314.867479",
"Type": "message",
"ChannelId": "C06UF15CB0V"
}

示例 - 创建“Reactions”实体的记录

此示例将创建 Reactions 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Reactions。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ChannelId": "C06UPA4KRD0",
  "Id": "1716375032.038669",
  "Type": "message",
  "Name": "raised_hands"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
  "Success": true
}

示例 - 创建“提醒”实体的记录

此示例将创建 Reminders 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Reminders。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "Text": "this is a reminder",
  "Time": "2025-10-15 14:30:00"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
  "Id": "Rm074P0X9JCV"
}

示例 - 创建 Channels 实体的记录

此示例将创建 Channels 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Channels。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"Name": "googlecloudcreatedchannel",
"IsPublic": true
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
"Id": "C074MBW5N2G"
}

示例 - 创建 MessageReplies 实体的记录

此示例将创建 MessageReplies 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 MessageReplies。
  3. 选择 Create 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"ChannelId": "C076HCY07UN",
"Text": "This is generated text",
"ParentMessageId": "1717659095.881619"
}

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

     
{
"Id": "1717659183.033599",
"ChannelId": C076HCY07UN,
"ParentMessageId": "1717659095.881619"
}

示例 - 更新“通话”实体的记录

以下示例会更新 Calls 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Calls。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "JoinURL": "https://example55.com/call/google-cloud",
  "Title": "title"
}
  5. 将实体 ID 设置为 R074LB76Q5R。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 R074LB76Q5R。

    您也可以将 filterClause 设置为 R074LB76Q5R，而不是指定 entityId。

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {
  "Id": "null"
}

示例 - 更新“Messages”实体的记录

以下示例会更新 Messages 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Messages。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "Text": "Google Cloud Updated Message"
}
  5. 将 filterClause 设置为 ChannelId = 'C06UPA4KRD0' 和 Id = '1716369465.000129'。如需设置 filterClause，请点击 filterClause，然后在默认值字段中输入 ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'。

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {
  "Id": null,
  "ChannelId": null
}

示例 - 更新 Users 实体的记录

此示例会更新 Users 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Users。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
  "ProfileDisplayName": "Vaibhav"
}
  5. 将实体 ID 设置为 U06Q6VDJYSU。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 U06Q6VDJYSU。

    您也可以将 filterClause 设置为 U06Q6VDJYSU，而不是指定 entityId。

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {
"Id": null
}

示例 - 更新 Channels 实体的记录

此示例会更新 Channels 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 Channels。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"Purpose": "This is the one channel that will always include everyone."
}
  5. 将实体 ID 设置为 C06MAP1JDSB。如需设置实体 ID，请点击 entityId，然后在默认值字段中输入 C06MAP1JDSB。

    您也可以将 filterClause 设置为 C06MAP1JDSB，而不是指定 entityId。

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {
"Id": "C06MAP1JDSB"
}

示例 - 更新 MessageReplies 实体的记录

以下示例会更新 MessageReplies 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 MessageReplies。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"Text": "Updated Text"
}
  5. 将 filterClause 设置为 ChannelId = 'C06UPA4KRD0' 和 Id = '1716369465.000129'。如需设置 filterClause，请点击 filterClause，然后在默认值字段中输入 ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'。

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {
"Id": null,
"ChannelId": null,
"ParentMessageId": null
}

示例 - 更新 UserProfile 实体的记录

以下示例会更新 UserProfile 实体的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 UserProfile。
  3. 选择 Update 操作，然后点击完成。
  4. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
     {
  "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
  "Phone": "8767787654",
  "StatusText": "Long train Journey to work"
 }

    如果集成成功，Connector 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    {

}

向 Google Cloud 社区寻求帮助

您可以在 Google Cloud 社区的 Cloud 论坛中发布您的问题以及讨论此连接器。

后续步骤