请参阅 Application Integration 支持的连接器。
网络钩子触发器
网络钩子触发器是一种连接器事件触发器,可让您根据任何支持网络钩子的事件来调用集成。
准备工作
如果您计划为 Webhook 触发器创建或配置新连接,请确保您拥有项目的以下 Identity and Access Management (IAM) 角色:
- 连接器管理员 (
roles/connectors.admin
)
如需了解如何授予角色,请参阅管理访问权限。
将以下 IAM 角色授予要用于网络钩子触发器的服务账号:
- Application Integration Invoker (
roles/integrations.integrationInvoker
)
如需了解如何向服务账号授予角色,请参阅管理对服务账号的访问权限。
添加网络钩子触发器
如需向您的集成添加网络钩子触发器,请执行以下步骤:
- 在 Google Cloud 控制台中,前往 Application Integration 页面。
- 在导航菜单中,点击集成
系统会显示集成列表页面,其中列出了 Google Cloud 项目中可用的所有集成。
- 选择现有集成,或点击创建集成以创建新的集成。
要创建新的集成,请执行以下操作:
- 在创建集成窗格中输入名称和说明。
- 为集成选择一个区域。
- 为集成选择服务账号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
- 点击创建。
系统随即会在集成编辑器中打开该集成。
- 在集成编辑器导航栏中,点击触发器查看可用触发器的列表。
- 点击网络钩子触发器元素并将其放置到集成编辑器中。
如需配置网络钩子触发器,您可以使用 Integration Connectors 中提供的现有网络钩子连接,也可以使用内嵌连接创建选项创建新的网络钩子连接。
使用现有连接配置网络钩子触发器
您可以使用 Integration Connectors 中的现有网络钩子连接来配置网络钩子触发器。请注意,网络钩子触发器是连接器事件触发器,因此,您只能使用已启用事件订阅的网络钩子连接来配置触发器。
如需了解如何使用新的 Webhook 连接配置 Webhook 触发器,请参阅使用新连接配置 Webhook 触发器
如需使用现有 Webhook 连接配置网络钩子触发器,请执行以下步骤:
- 点击集成编辑器中的网络钩子触发器元素,打开触发器配置窗格。
- 点击配置触发器。
- 在连接器事件触发器编辑器页面中提供以下配置详细信息:
- 点击完成以完成触发器配置并关闭页面。
使用新连接配置网络钩子触发器
如需使用新的 Webhook 连接配置网络钩子触发器,请执行以下步骤:
- 点击集成编辑器中的网络钩子触发器元素,打开触发器配置窗格。
- 点击配置触发器。
- 跳过区域字段。
- 点击连接,然后从菜单中选择创建连接选项。
- 在 Create Connection 窗格中完成以下步骤:
- 在位置部分中,选择连接的位置。
- 区域:从列表中选择一个地理位置。
支持的连接器区域包括:
如需查看所有受支持区域的列表,请参阅位置。
- 点击下一步。
- 区域:从列表中选择一个地理位置。
- 在 Connection Details 部分中,完成以下操作:
- 连接器:从可用连接器下拉列表中选择网络钩子。
- 连接器版本:从可用版本的下拉列表中选择连接器版本。
- Connection Name:输入连接实例的名称。
连接名称必须满足以下条件:
- 连接名称可以使用字母、数字或连字符。
- 字母必须小写。
- 连接名称必须以字母开头,以字母或数字结尾。
- 连接名称不能超过 63 个字符。
- 说明:(可选)输入连接实例的说明。
- 服务账号:选择具有所需角色的服务账号。
- 事件订阅:默认情况下,事件订阅将处于启用状态,对于 webhook 连接器而言是必需的。
- (可选)点击 + 添加标签,以键值对的形式向连接添加标签。
- 点击下一步。
-
在 Event Subscription Details 部分中,完成以下操作:
- 监听器身份验证:为事件监听器选择身份验证类型,然后输入相关详情。
网络钩子监听器支持以下身份验证类型:
- 无需身份验证
- Google 身份验证:确保服务账号具有 roles/connectors.listener 角色,其访问令牌用于身份验证。
- API 密钥身份验证
- 基本身份验证
- 事件类型字段位置:必填字段,用于指明与传入事件请求关联的事件类型的显示位置(标头、查询参数或请求正文)。
- 事件类型字段名称:所配置位置中的必填字段用于标识 与传入事件请求相关联的事件类型。
- 选择启用专用连接以在后端应用之间实现安全连接 以及你的人脉关系如果您选择此选项,则必须执行额外的配置步骤 。如需了解详情,请参阅适用于事件订阅的专用连接。
- 输入死信配置。如果您配置了死信,则连接会写入
将未处理的事件发送到指定的 Pub/Sub 主题。输入以下详细信息:
- 死信项目 ID :您在其中配置了死信 Pub/Sub 主题的 Google Cloud 项目的 ID。
- 死信主题 :您要在其中写入未处理事件详细信息的 Pub/Sub 主题。
- 点击下一步。
{ "event_type": "user.created", ... // other request fields ... }
在上面的示例中,请求正文中的 event_type 字段表示该请求与“user.created”有关事件。 - 监听器身份验证:为事件监听器选择身份验证类型,然后输入相关详情。
- 审核:查看您的连接和监听器身份验证详细信息。
- 点击创建。
- 在位置部分中,选择连接的位置。
触发器输出
网络钩子触发器需要几分钟才能完成事件订阅配置。您可以在事件订阅详情下的触发器配置窗格中查看事件订阅的状态。
网络钩子触发器使用以下状态指示事件订阅的状态:
Creating
:表示触发器正在订阅事件订阅。Active
:表示触发器已成功订阅事件订阅。Error
:表示已配置的事件订阅存在问题。
除了事件订阅状态之外,事件订阅详情部分还会显示其他详细信息,例如连接区域、连接名称、事件订阅名称等。
触发器输出变量
对于每个事件,网络钩子触发器都会生成一个 ConnectorEventPayload
输出变量,供您在下游任务中使用。输出变量采用 JSON 格式,包含输出网络钩子载荷架构。
查看事件订阅
要查看和管理与 Integration Connectors 中的连接关联的所有事件订阅,请执行以下操作:
- 转到集成连接器 >连接页面。
- 点击要查看其订阅的连接。
- 点击活动订阅标签页。
这会显示该连接的所有事件订阅。
修改网络钩子触发器
您可以修改网络钩子触发器,以更改或更新连接配置和事件订阅详细信息。
如需修改网络钩子触发器,请执行以下步骤:
- 点击集成编辑器中的网络钩子触发器元素,打开触发器配置窗格。
- 点击配置网络钩子触发器。
- 在连接器事件触发器编辑器页面中执行以下操作:
- 如要保留之前配置的事件订阅,请点击保留,否则请点击删除。
- 根据需要更新连接配置和事件订阅详情。
- 点击完成。
您可以在事件订阅详情下的触发器配置窗格中查看更新后的连接和事件订阅详细信息。