如何从 Workspace Studio 调用外部 API

Google Workspace Studio 工作流可能需要来自 Gmail、云端硬盘或聊天之外的数据：例如订单状态、数据库中的数字或内部工具的响应。要检索这些数据或将信息发送到其他服务，您可以添加相应的步骤。 发送 webhook这会向您指定的 API 地址发出 HTTP 请求。

您无需配置 Gemini 函数调用即可发出该请求。在 Workspace Studio 中，流程会执行 webhook 步骤并接收响应。然后，如果您觉得有用，可以将该响应传递到另一个步骤，以便对其进行汇总、提取数据或传达结果。

连接 API 之前需要准备什么？

第一步是验证您的组织是否可以使用 Webhook。该功能位于： 限量预览 默认情况下处于禁用状态。管理员必须登录。 应用 > Google Workspace > Workspace Studio > Webhook 设置 并为相应的组织单元启用该功能。

在某些版本中，管理员还可以将连接数限制为一个。 允许的域名和网址列表如果该步骤出现在 Studio 中但无法与您的 API 通信，请验证目标地址是否已获得授权。此外，默认情况下，涉及 Webhook 的操作需要用户在执行前审核并确认该步骤。

对于外部服务，您需要了解其 URL、支持的 HTTP 方法以及期望的数据格式。此外，还要检查其身份验证方式：公共只读 API 的要求与需要令牌或特殊标头的私有 API 的要求不同。

如何从 Workspace Studio 调用 API（分步指南）

进入 studio.workspace.google.com 然后创建包含所需触发器的工作流。例如，您可以将其设置为在收到符合特定条件的电子邮件时启动。接下来，请按照以下步骤操作：

1. 按 添加步骤 并选择 发送 webhook.
2. 进入 完整网址 API，包括前缀 https://地址必须固定：此字段不支持流变量。
3. 选择HTTP方法。 得到 它用于查询数据； 邮政可以发送或创建记录。它们也可用。 PUT、PATCH 和 DELETE.
4. 如果 API 需要请求体，请将其写入内容字段或 有效载荷Google建议在接收服务需要JSON格式时使用JSON。
5. 制作一个 测试执行检查结果，确认其有效后激活该流程。

请记住，测试 执行该操作如果您配置了 POST 请求来创建记录或 DELETE 请求来删除记录，请先使用测试环境或您可以无故障修改的数据。

例如：向外部工具发送通知

想象一下，你的团队有一个 API，可以创建警报 https://api.ejemplo.com/v1/avisos这个地址是 举例说明您需要将其替换为您服务中的相应组件。如果它的文档表明它接受 POST 请求和 JSON 请求体，您可以配置该步骤并添加类似以下内容： {"tipo":"nuevo_correo","origen":"Workspace Studio"}.

您还可以插入一个 流量变量 例如，可以在正文中包含触发邮件的主题。通过 Studio 的变量选择器执行此操作并检查结果：如果插入的文本包含引号或其他特殊字符，则可能会导致 JSON 格式错误。变量可以在内容中使用，但是…… 不在 URL 字段中.

如果需要检索数据，请选择 GET 请求并输入一个已包含必要参数的固定 URL。Workspace Studio 将忽略您在 GET 请求正文中编写的任何内容。

如何处理 API 响应

webhook 步骤会离开 服务响应（文本） 数据将以变量的形式提供给后续步骤。您可以使用它来发送通知、生成摘要，或指示 AI 步骤提取特定数据。

例如，如果 API 返回订单状态，下一步可以将该状态传达给团队。请显式选择包含响应的变量：后续步骤不会自动接收流程中先前发生的所有内容。建议在编写依赖于返回内容的指令之前，先测试返回的内容。

如果 API 需要身份验证或更复杂的逻辑

文档中记录的基本配置 发送 webhook 它包含 URL、方法以及可选的请求体。如果您的集成需要获取 OAuth 令牌、构建带有可变参数的 URL、添加特定标头或在继续操作之前转换响应，请检查此步骤是否满足这些要求。

如果这种方法行不通，另一种选择是开发一种 Workspace Studio 的自定义步骤 通过插件。在 Google Apps Script 实现中，该服务 UrlFetchApp 它允许您向外部 API 发出请求并处理 JSON 响应。此解决方案需要开发和正确的权限配置；对于原生步骤已经可以处理的简单请求，则无需此方案。

避免将私钥粘贴到流程的可见字段中，或将其嵌入到共享 URL 中。在从 Gmail、Chat 或日历发送数据之前，请确认外部服务将接收哪些信息，以及它是否已获得处理这些信息的授权。

如何定位 webhook 中的错误

如果连接失败，请打开选项卡 活动 在流程图中，您可以查看完整的错误信息以及目标服务器发送的响应。这些信息有助于区分 Studio 配置问题和 API 拒绝的请求。

• 该步骤未显示： 请向管理员确认您的组织单位是否已启用 Webhook。
• 该网址已被屏蔽： 如果您的版本使用了地址限制，请查看允许的地址列表。
• 错误 400： 检查请求体格式和 API 要求的字段。
• 错误代码 401 或 403： 检查服务所需的权限和身份验证方法。
• 错误 429： 检查您是否已超过目标 API 的请求限制。
• 错误 500： 查看接收请求的服务的状态和记录。

另请注意 Workspace Studio 的一般限制：它目前最多支持 每个用户 25 个流量 y 每个流程 20 个步骤此外，还有一个每 24 小时重置一次的合并执行次数限制。如果多个流程停止运行，请先检查它们的活动，然后再将故障归咎于 API。

对于大多数简单的 HTTP 连接，流程很简单：启用 Webhook，配置固定 URL 和正确的方法，测试请求，然后在后续步骤中使用响应。如果集成需要高级身份验证或通过代码转换数据，则需要准备一个自定义步骤。