查看 Application Integration 支持的连接器。

API 触发器

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

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

添加 API 触发器

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

    转到 Application Integration

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

    系统随即会显示 Integrations List（集成列表）页面，其中列出了 Google Cloud 项目中可用的所有集成。

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

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

    1. 在创建集成窗格中输入名称和说明。
    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://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

请替换以下内容：

  • TRIGGER_NAME：您的集成中 API 触发器的名称。
  • PROJECT_ID：您的 Google Cloud 项目的 ID。
  • LOCATION：您的 Google Cloud 项目的位置。

示例

以下示例调用了 us-east1 区域中的集成，该区域包含 demo-project Google Cloud 项目中的 test_API_1 API 触发器：

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，应用集成不会运行集成，并且会出现错误。

配额和限制

如需了解配额和限制，请参阅配额和限制。

后续步骤