Poller

Poller 触发器会定期检查数据源是否有更新。 配置后,Poller 会定期使用数据源的轮询 URL 检查是否有新数据。 Poller 适合实时更新不可用或更新频率较低的场景。

概览

Poller 基于轮询机制运行,触发器会定期向轮询 URL 发送请求,以获取新数据。 您可以配置 Poller 以接收传入的事件通知,并根据通知启动后续的自动化。 应用程序的轮询器 URL 用作触发器轮询新事件的终端节点。

您可以为 GET 调用或 POST 调用配置 Poller。 配置 Poller 时,必须添加标头参数、查询参数、上下文管理详细信息以及 JSON 过滤器。 POST 选项包含添加请求正文的功能。 您可以使用此选项向轮询器 URL 发送数据,该 URL 需要额外的事件数据。

设置

以下设置适用于 Listener 触发器:

轮询器的设置面板

名称
指定 Poller 的名称
轮询 URL
指定应用程序的轮询 URL。
请求类型
选择 API 请求类型。Poller 支持 GETPOST 方法。
  • GET - 可以使用 GET 方法获取事件详细信息。
  • POST - 可以使用 POST 方法限制响应数据。 POST 方法提供添加请求正文的功能。 此选项作为过滤器使用,用于限制响应数据。
请求正文
输入 POST 方法的请求正文。 可以添加 TXTJSONXMLHTML 等格式的请求正文。
轮询间隔
设置轮询该 URL 以获取新信息的频率。 可以将间隔时间设置为分钟小时。 间隔时间的最小限制为 5 分钟。
身份验证类型
指定触发器的身份验证模式。 可以选择无身份验证OAuth2 - Control Room 托管
连接
使用选择按钮,选择现有的 OAuth 连接作为身份验证模式。 确保连接已设置并处于活动状态。
添加标头
指定适用于轮询请求的标头参数。 您可以添加身份验证标头和其他必须包含在请求标头中的唯一参数。
启用添加标头复选框,并单击添加标头以打开项目模态框。 在项目模态框中指定标头参数名称和值。
添加查询参数
指定适用于轮询请求的查询参数。 启用复选框并单击添加标头以打开项目模态框。
启用添加查询参数复选框,并单击添加查询以打开项目模态框。 在项目模态框中指定查询参数名称和值。
上下文管理
定义任何动态参数的上下文管理。 该触发器使用上下文作为轮询检查点,以确保获取在上一个检查点之后更新的信息。 您可以为轮询 URL、标头和查询参数定义上下文管理。 将该参数定义为字符串,并使用该字符串定义上下文。
例如,Gmail API 轮询使用邮件的历史 ID 来确定邮箱中的更改。 在为 Gmail 收件箱配置 Poller 触发器时,您可以在轮询 URL 中定义历史 ID,例如 https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} ,或者通过添加名称为 startHistoryId 的查询参数,并将其值设置为 historyID。 然后,您可以使用收件箱收到的最后一封邮件的历史 ID 作为轮询的检查点,为历史 ID 配置上下文。 您还必须在更新上下文字段中添加在响应负载中捕获历史记录 ID 的 JSON 节点。 这可确保每次触发器运行时,触发器都会将最后收到的电子邮件的 ID 作为起始历史 ID。
启用上下文管理复选框,并单击添加上下文以打开项目模态框。 请在项目模态框中指定上下文键和值。 您可以选择以下任一项作为更新上下文的条件:
  • Json 表达式: 选择此选项可将响应有效负载的 JSON 节点设置为上下文。
  • 当前时间戳 (Unix): 选择此选项可将查询参数的 Unix 纪元时间戳设置为上下文。
  • 当前时间戳 (ISO 8601): 选择此选项可将查询参数的 ISO 8601 时间戳设置为上下文。
Json 过滤器
为响应数据指定一个过滤器。 此设置可根据您的需求对数据进行过滤。 例如,如果 JSON 数据包含长度为 1、5、10、25 和 30 的多条记录,可以将 JSON 过滤器定义为 record.length>10 ,该过滤器会丢弃长度小于 10 的记录。
响应
选择一个记录变量以保存触发器响应数据。 自动化以键值对的格式保存触发器响应数据。 执行机器人后,前往审核日志页面,选择由触发器运行的机器人事件,以查看响应数据。