如何通过Quip API正确创建新的电子表格

问题原因 #

报错核心原因有两点：

• 封装好的client.new_document()方法默认仅创建普通文本文档，无特殊参数时不会生成电子表格
• 你当前使用的Quip SDK版本中，new_document方法未开放type入参，强行传入会触发未知关键字报错，不能直接照搬零散教程里的传参写法。

正确实现方式 #

不要使用通用的new_document方法，直接调用SDK底层请求方法，对接Quip原生的新建电子表格接口即可，支持创建时直接写入从数据库提取的表头和内容：

# 替换成你从数据库实际查询到的表头、表数据
table_headers = ["列名1", "列名2", "列名3"]
table_rows = [
    ["行1数据1", "行1数据2", "行1数据3"],
    ["行2数据1", "行2数据2", "行2数据3"]
]

# 拼接Quip接口要求的HTML表格格式内容
html_content = ["<table>"]
# 拼接表头
html_content.append("<tr>" + "".join([f"<th>{h}</th>" for h in table_headers]) + "</tr>")
# 拼接内容行
for row in table_rows:
    html_content.append("<tr>" + "".join([f"<td>{cell}</td>" for cell in row]) + "</tr>")
html_content.append("</table>")
final_content = "".join(html_content)

# 调用接口创建电子表格
new_ss = client._request(
    method="POST",
    path="threads/new-spreadsheet",
    post_data={
        "title": "New Spreadsheet",
        "member_ids": [user["private_folder_id"]],
        "content": final_content
    }
)

注意事项 #

• 接口返回结果中会包含新建电子表格的thread_id，后续需要修改、追加表格内容时可以基于这个ID调用对应编辑接口
• 如果你使用的是最新版Quip SDK，也可以直接调用SDK封装好的client.new_spreadsheet()方法，入参格式和上述post_data保持一致即可，不需要走底层_request调用
• 不要尝试修改SDK源码给new_document加type参数，直接调用专用电子表格接口是兼容性最高的方案

内容的提问来源于stack exchange，提问作者Jen C