请参阅 Application Integration 支持的连接器。

API 触发器

API 触发器用于直接调用集成的执行。API 触发器可以在同步模式或异步模式下使用。

您可以通过在集成中创建变量，为 API 触发器设置请求和响应载荷。如需了解如何创建与 API 触发器的集成，以接收用于检索客户信息的 API 请求，请参阅 API 执行方式教程。

添加 API 触发器

如需添加 API 触发器，请执行以下步骤：
  1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

    转到 Application Integration

  2. 在导航菜单中，点击 Integrations（集成）

    此时将显示集成列表页面，其中列出了 Google Cloud 项目中提供的所有集成。

  3. 选择现有集成，或点击创建集成以创建新集成。

    要创建新的集成，请执行以下操作：

    1. 在 Create Integration（创建集成）窗格中输入名称和说明。
    2. 选择集成区域。
    3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
    4. 点击创建。

    系统会在集成编辑器中打开集成。

  4. 在集成编辑器导航栏中，点击触发器以查看可用触发器的列表。
  5. 点击 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 不会运行集成，并且您会收到错误。