请参阅 Application Integration 支持的连接器。
API 触发器
API 触发器用于直接调用集成的执行。API 触发器可以在同步模式或异步模式下使用。
您可以通过在集成中创建变量,为 API 触发器设置请求和响应载荷。如需了解如何创建与 API 触发器的集成,以接收用于检索客户信息的 API 请求,请参阅 API 执行方式教程。
添加 API 触发器
如需添加 API 触发器,请执行以下步骤:- 在 Google Cloud 控制台中,前往 Application Integration 页面。
- 在导航菜单中,点击 Integrations(集成)
此时将显示集成列表页面,其中列出了 Google Cloud 项目中提供的所有集成。
- 选择现有集成,或点击创建集成以创建新集成。
要创建新的集成,请执行以下操作:
- 在 Create Integration(创建集成)窗格中输入名称和说明。
- 选择集成区域。
- 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
- 点击创建。
系统会在集成编辑器中打开集成。
- 在集成编辑器导航栏中,点击触发器以查看可用触发器的列表。
- 点击 API 触发器元素,并将其放置到设计器中。
配置 API 触发器
点击集成编辑器中的 API trigger 元素以查看触发器配置窗格。
配置面板会显示触发器 ID,这是机器生成的 ID,格式为 api_trigger/TRIGGER_NAME
。此触发器无需进一步配置。
从应用调用 API 触发器
发布配置了 API 触发器的集成后,您可以使用projects.locations.integrations.execute
方法从任何应用调用该触发器。此方法会在同步模式下触发执行。
语法
curl -X POST \ -H "authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \ "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"
请替换以下内容:
TRIGGER_NAME
:集成中 API 触发器的名称。PROJECT_ID
:您的 Google Cloud 项目的 ID。LOCATION
:您的 Google Cloud 项目的位置。
示例
以下示例会调用 demo-project
Google Cloud 项目中包含 test_API_1
API 触发器的 us-east1
区域中的集成:
curl -X POST \ -H "authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" \ -d '{"trigger_id":"api_trigger/test_API_1"}' \ "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"
注意事项
使用 API 触发器时,所有输入变量的累计大小不能超过 8 MB。如果大小超过 8 MB,则 Application Integration 不会运行集成,并且您会收到错误。