飞书多维表格数据自动汇总需通过开放平台api调用真实数据,先获取access_token并配置正确权限与安装应用,再分页请求记录并解析嵌套字段进行pandas汇总计算。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在飞书多维表格中自动汇总销售数据、项目进度或用户反馈时,需通过飞书开放平台API调用真实数据,不能仅靠本地Excel逻辑模拟;脚本必须先获取有效access_token,再构造正确字段路径请求,否则返回空结果或401错误。
获取飞书应用凭证与权限
登录飞书开放平台→进入「云文档」类应用→复制App ID和App Secret。
在「权限配置」中勾选【多维表格:读取数据】和【身份验证:获取用户基本信息】,否则后续调用table_records.list接口会返回403。
点击「安装到租户」并完成管理员授权,这一步不可跳过,【未安装的应用无法访问任何多维表格数据】。
用requests调用多维表格记录列表
方法一:基础GET请求(适合单页≤500条)
拼接URL:https://www.php.cn/link/127f75906618c4a0d33d9188ac6df110/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records?page_size=500,其中app_token和table_id需从多维表格URL中提取:https://base.feishu.cn/base/{app_token}?table={table_id}。
设置Headers:'Authorization': 'Bearer {access_token}',注意Bearer后有空格;access_token需用App ID+App Secret调用/auth/v3/app_access_token/internal/接口换取,有效期2小时。
方法二:分页循环拉取(数据超500条必用)
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。
第一步:发送首次请求,解析响应中的has_more和page_token字段。
第二步:若has_more == True,将page_token作为参数追加到下次请求URL末尾,如&page_token=xxx。
第三步:每次响应的items列表合并进总数据池,直到has_more为False为止——漏掉这步会导致只拿到前500条。
解析并汇总字段值
飞书多维表格返回的record字段是嵌套结构,数值型字段如「销售额」实际藏在fields.销售额.number里,文本字段在fields.客户名称.text,日期字段需用fields.签约时间.date.string提取ISO格式字符串。
用pandas.DataFrame处理时,先用列表推导式扁平化每条record:
[{ "销售额": r["fields"].get("销售额", {}).get("number", 0), "状态": r["fields"].get("状态", {}).get("text", "") } for r in records]
对「销售额」列执行df["销售额"].sum()即可得到汇总值;若要按「状态」分组求和,用df.groupby("状态")["销售额"].sum()。
注意:字段名必须与多维表格中显示的中文名完全一致,包括空格和标点,否则get()返回None导致计算中断。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










