​扣子Coze飞书多维表插件-查询数据

search_record - 查询数据

请求参数

• apptoken - 多维表的唯一标识服

可选参数：

• automatic_fields - 控制是否返回自动计算的字段, true 表示返回。

• field_names - 字段名称，用于指定本次查询返回记录中包含的字段。

  • 示例值：["字段1","字段2"]。默认返回全部

• filter - 筛选条件

  • conjunction - 表示条件之间的逻辑连接词，该字段必填，请忽略左侧必填列的否

  • conditions - 筛选条件集合

    • field_name - 筛选条件的左值，值为字段的名称

    • operator - 条件运算符

      • is：等于

      • isNot：不等于（不支持日期字段，了解如何查询日期字段，参考日期字段填写说明）

      • contains：包含（不支持日期字段）

      • doesNotContain：不包含（不支持日期字段）

      • isEmpty：为空

      • isNotEmpty：不为空

      • isGreater：大于

      • isGreaterEqual：大于等于（不支持日期字段）

      • isLess：小于

      • isLessEqual：小于等于（不支持日期字段）

      • like：LIKE 运算符。暂未支持

      • in：IN 运算符。暂未支持

    • value - 条件的值，可以是单个值或多个值的数组。不同字段类型和不同的 operator 可填的值不同。

• page_size - 分页大小，默认值为 20，最大值为 500。, default value is 20

• page_token - 分页标记

  • 第一次请求不填，表示从头开始遍历

  • 分页查询结果还有更多项时会同时返回新的 page_token

  • 下次遍历可采用该 page_token 获取查询结果。

• sort - 排序条件列表

  • 例如：[{"field_name":"多行文本","desc":true}] desc为倒序排序

• table_id - 多维表格数据表的唯一标识符

• table_name - 多维表格数据表的名称

• user_id_type - 用户 ID 类型

  • 可选值有 open_id、union_id、user_id，默认值为 open_id。 , default value is open_id

• view_id - 视图的唯一标识符，获取指定视图下的记录。

测试数据

请求参数

{ "app_token": "https://gwl1554ppni.feishu.cn/base/EsuGbiV5rakvlVsbbIQcWW72npb?table=tblw9FyMElU6UGBf&view=vewM6bekwO", "filter": { "conditions": [ { "field_name": "系列", "operator": "is", "value": [ "Coze" ] }, { "field_name": "pv", "operator": "isGreater", "value": [ "50" ] } ], "conjunction": "and" } }

返回值

{ "data": { "items": [ { "fields": "{\"Token\":[{\"type\":\"text\",\"text\":\"G8YSwgk7MiW7rbkxCLcc35VjnPf\"}],\"pv\":425,\"创建时间\":1740807294000,\"字符数\":5500,\"更新时间\":1742136639000,\"uv\":270,\"平台\":\"飞书\",\"数据更新时间\":1743004504426,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/G8YSwgk7MiW7rbkxCLcc35VjnPf\",\"text\":\"首页\"},\"系列\":\"Coze\"}", "record_id": "recjJSQp06" }, { "fields": "{\"pv\":102,\"uv\":79,\"创建时间\":1740826221000,\"更新时间\":1740826304000,\"系列\":\"Coze\",\"Token\":[{\"type\":\"text\",\"text\":\"PCuHwQCloiaAAkkNhI6ctobXnqc\"}],\"字符数\":10,\"平台\":\"飞书\",\"数据更新时间\":1743004507420,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/PCuHwQCloiaAAkkNhI6ctobXnqc\",\"text\":\"Coze扣子平台\"}}", "record_id": "recuEVknQ8hZuj" }, { "fields": "{\"平台\":\"飞书\",\"数据更新时间\":1743004518277,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/FHcFwJJo6ieNbzkwaCbcFsxxnHf\",\"text\":\"1-智能体篇\"},\"字符数\":9,\"更新时间\":1740834043000,\"系列\":\"Coze\",\"Token\":[{\"text\":\"FHcFwJJo6ieNbzkwaCbcFsxxnHf\",\"type\":\"text\"}],\"pv\":99,\"uv\":74,\"创建时间\":1740809390000}", "record_id": "recuEVOHBN6NWp" }, { "fields": "{\"创建时间\":1740809401000,\"字符数\":11,\"文章\":{\"text\":\"2-工作流篇\",\"link\":\"https://gwl1554ppni.feishu.cn/wiki/ThR1wXATEiL0Q9k8BvMcr9Ban6c\"},\"更新时间\":1742716790000,\"系列\":\"Coze\",\"Token\":[{\"text\":\"ThR1wXATEiL0Q9k8BvMcr9Ban6c\",\"type\":\"text\"}],\"uv\":72,\"数据更新时间\":1743004521176,\"pv\":104,\"平台\":\"飞书\"}", "record_id": "recuEVOPyzJmPa" }, { "fields": "{\"Token\":[{\"text\":\"XCKbwWzRQiK25fkeeyFcWGilnnc\",\"type\":\"text\"}],\"uv\":32,\"创建时间\":1740810269000,\"更新时间\":1742716795000,\"系列\":\"Coze\",\"pv\":51,\"字符数\":2822,\"平台\":\"飞书\",\"数据更新时间\":1743004524193,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/XCKbwWzRQiK25fkeeyFcWGilnnc\",\"text\":\"2.1 初识工作流\"}}", "record_id": "recuEVORZE0hwH" }, { "fields": "{\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/ElhEwZFyFiqIcZkP8SZclsyZnEo\",\"text\":\"3-插件篇\"},\"更新时间\":1742716905000,\"系列\":\"Coze\",\"Token\":[{\"type\":\"text\",\"text\":\"ElhEwZFyFiqIcZkP8SZclsyZnEo\"}],\"pv\":86,\"创建时间\":1740809416000,\"平台\":\"飞书\",\"uv\":54,\"字符数\":9,\"数据更新时间\":1743004574659}", "record_id": "recuEVPsRo9tSb" }, { "fields": "{\"创建时间\":1740809427000,\"字符数\":8,\"数据更新时间\":1743004584848,\"uv\":47,\"pv\":68,\"平台\":\"飞书\",\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/VK6wwe8NwiF5rikbtdZc3l2bnCg\",\"text\":\"4-应用篇\"},\"更新时间\":1740834065000,\"系列\":\"Coze\",\"Token\":[{\"text\":\"VK6wwe8NwiF5rikbtdZc3l2bnCg\",\"type\":\"text\"}]}", "record_id": "recuEVPCgn3ZC5" }, { "fields": "{\"pv\":104,\"uv\":69,\"创建时间\":1740809441000,\"字符数\":16,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/IGziwUUieisNq7kP1qGcoIgRnXe\",\"text\":\"5-API/SDK部署篇\"},\"更新时间\":1742716942000,\"Token\":[{\"text\":\"IGziwUUieisNq7kP1qGcoIgRnXe\",\"type\":\"text\"}],\"平台\":\"飞书\",\"数据更新时间\":1743004587515,\"系列\":\"Coze\"}", "record_id": "recuEVPECeHw6X" }, { "fields": "{\"pv\":111,\"uv\":75,\"创建时间\":1741104472000,\"平台\":\"飞书\",\"数据更新时间\":1743004590177,\"Token\":[{\"text\":\"RLUawGZj2i7MTiksHPGccx99nFb\",\"type\":\"text\"}],\"字符数\":1696,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/RLUawGZj2i7MTiksHPGccx99nFb\",\"text\":\"5.1 Chat SDK部署指南\"},\"更新时间\":1742716946000,\"系列\":\"Coze\"}", "record_id": "recuEVPGdxAupE" }, { "fields": "{\"更新时间\":1742716949000,\"pv\":96,\"平台\":\"飞书\",\"数据更新时间\":1743004592650,\"字符数\":1362,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/K1d3wofDniJXNEkhYOOcjYKonXd\",\"text\":\"5.2 使用JWT获取Access Token\"},\"系列\":\"Coze\",\"Token\":[{\"text\":\"K1d3wofDniJXNEkhYOOcjYKonXd\",\"type\":\"text\"}],\"uv\":58,\"创建时间\":1741171183000}", "record_id": "recuEVPHVYgNku" }, { "fields": "{\"数据更新时间\":1743004595125,\"更新时间\":1740834088000,\"系列\":\"Coze\",\"uv\":45,\"创建时间\":1740809460000,\"平台\":\"飞书\",\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/TSmMwbcbdiHfArkwms7clAOjnEc\",\"text\":\"6-其他篇\"},\"Token\":[{\"text\":\"TSmMwbcbdiHfArkwms7clAOjnEc\",\"type\":\"text\"}],\"pv\":66,\"字符数\":8}", "record_id": "recuEVPJGXlMal" }, { "fields": "{\"uv\":38,\"字符数\":9,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/LjGbwdIWniQBueknz7scXfyXnxd\",\"text\":\"7-常见问题\"},\"更新时间\":1740834096000,\"系列\":\"Coze\",\"Token\":[{\"text\":\"LjGbwdIWniQBueknz7scXfyXnxd\",\"type\":\"text\"}],\"pv\":73,\"创建时间\":1740809501000,\"平台\":\"飞书\",\"数据更新时间\":1743004597383}", "record_id": "recuEVPLvgWRnj" }, { "fields": "{\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/TdAbwX4X8i5GtRk9MidcRHUunTc\",\"text\":\"8-项目实战\"},\"更新时间\":1742717002000,\"系列\":\"Coze\",\"Token\":[{\"type\":\"text\",\"text\":\"TdAbwX4X8i5GtRk9MidcRHUunTc\"}],\"uv\":34,\"字符数\":10,\"平台\":\"飞书\",\"数据更新时间\":1743004609628,\"pv\":65,\"创建时间\":1740810894000}", "record_id": "recuEVPUsXveGk" }, { "fields": "{\"Token\":[{\"type\":\"text\",\"text\":\"NtCowtahaiS7vGkKilYcwQDHnDe\"}],\"pv\":68,\"字符数\":1694,\"平台\":\"飞书\",\"数据更新时间\":1743004634882,\"更新时间\":1742717050000,\"系列\":\"Coze\",\"uv\":37,\"创建时间\":1741077873000,\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/NtCowtahaiS7vGkKilYcwQDHnDe\",\"text\":\"8.4.1 将智能体部署到网页\"}}", "record_id": "recuEVQck6R07q" }, { "fields": "{\"pv\":58,\"字符数\":360,\"平台\":\"飞书\",\"文章\":{\"link\":\"https://gwl1554ppni.feishu.cn/wiki/Q5eYwgCPNiMLDtkm9jDcEzY1nJe\",\"text\":\"8.4.2 纯前端部署多Agents\"},\"系列\":\"Coze\",\"Token\":[{\"text\":\"Q5eYwgCPNiMLDtkm9jDcEzY1nJe\",\"type\":\"text\"}],\"uv\":31,\"创建时间\":1741269265000,\"数据更新时间\":1743004637350,\"更新时间\":1742717056000}", "record_id": "recuEVQe7iVP0u" } ], "page_token": null, "total": 15, "has_more": false }, "log_id": "202503271911263303FA2F66AD2A1FAD79", "msg": "success", "code": 0 }

返回值

• items - 返回的数据

  • fields - 本行的数据

  • record_id - 该行的ID，后续可用这个ID修改这行数据

 

本文转载自：https://gwl1554ppni.feishu.cn/wiki/G8YSwgk7MiW7rbkxCLcc35VjnPf