You need to enable JavaScript to run this app. 使用Python的simple-smartsheet库无法下载Smartsheet行附件怎么办?
优惠活动
大模型
产品
解决方案
定价
更多

使用Python的simple-smartsheet库无法下载Smartsheet行附件怎么办?

问题根因

simple-smartsheet 调用sheets.get()获取工作表数据时,不会主动加载每行的附件关联数据,接口返回的行对象attachments字段默认是空列表,需要单独调用附件查询接口获取对应行的附件信息。

修复后可直接运行的代码
import config
import requests
from simple_smartsheet import Smartsheet

# 初始化Smartsheet客户端,需提前在config里配置SMARTSHEET_API_TOKEN参数
smartsheet = Smartsheet(config.SMARTSHEET_API_TOKEN)

sheet = smartsheet.sheets.get(id=config.SHEET_ID) 
for row in sheet.rows:
    # 单独查询当前行的附件列表
    attachments = smartsheet.attachments.list(sheet_id=config.SHEET_ID, row_id=row.id)
    print(f"行ID {row.id} 附件数量:{len(attachments)}")
    
    # 附件下载逻辑
    for att in attachments:
        # 自定义附件本地保存路径,示例为保存在当前运行目录下,保留原附件名称
        save_path = f"./{att.name}"
        # 下载附件时需要在请求头携带API鉴权信息
        resp = requests.get(
            att.url,
            headers={"Authorization": f"Bearer {config.SMARTSHEET_API_TOKEN}"}
        )
        # 校验请求是否成功,权限不足/链接过期会直接抛出异常
        resp.raise_for_status()
        # 写入本地文件
        with open(save_path, "wb") as f:
            f.write(resp.content)
        print(f"附件 {att.name} 下载完成,保存路径:{save_path}")
注意事项
  • 你需要提前安装requests依赖,执行命令:pip install requests
  • 确保你的Smartsheet API Token有对应工作表的附件查看权限,否则会触发403鉴权失败
  • Smartsheet返回的附件下载链接有效期仅为5分钟,不要缓存链接后延迟下载
  • 如果工作表行数多、附件体积大,可以适当添加请求间隔,避免触发API限流规则

内容的提问来源于stack exchange,提问作者Guilherme Aguiar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 21:06:08