使用 Python SDK 将数据写入飞书多维表格

一、飞书开放平台配置

在使用代码之前，需要先创建一个'机器人'身份并赋予相应权限。

1. 创建应用 登录 飞书开放平台，创建一个企业自建应用。
2. 配置权限 进入应用的'权限管理'页面，搜索并开通以下权限（Scope）：
   • bitable:app（查看、评论、编辑和管理多维表格）
   • base:record:create（新增记录）

二、获取多维表格信息

代码中需要定位到具体的表格，需要从浏览器地址栏中获取以下两个 ID。

1. 打开目标多维表格 使用浏览器访问你需要写入数据的表格。
2. 提取 ID 观察浏览器地址栏的 URL，格式通常如下： https://base_url/base/{app_token}?table={table_id}
   • App Token：紧跟在 base/ 后面的那串字符。
   • Table ID：URL 参数中 table= 后面的那串字符。

三、文档授权（关键步骤）

仅有 API 权限是不够的，还需要将应用'拉入'具体的文档中，否则会报错 Forbidden (91403)。

1. 在多维表格页面右上角，点击 '…'（菜单按钮）。
2. 选择 '更多' -> '添加文档应用'。
3. 在搜索框中输入你在第一步创建的应用名称。
4. 点击添加，并务必勾选 '可编辑' 权限。

四、安装环境

在本地 Python 环境中安装飞书官方 SDK：

pip install lark-oapi

五、代码实现

完成以上配置后，将 App Token、Table ID 以及应用的 App ID 和 App Secret 填入代码即可运行。

import lark_oapi as lark
from lark_oapi.api.bitable.v1 import *

# ================= 配置信息 =================
APP_ID = "cli_xxxx"
APP_SECRET = "2JBE7yyyyyy"
APP_TOKEN = "VvgbbVCOzalrcfsxxxxxxx"
TABLE_ID = "tblMGgT4yyyyyyy"
# ===========================================

def save_to_feishu_sdk(text_content):
    
    client = lark.Client.builder() \
        .app_id(APP_ID) \
        .app_secret(APP_SECRET) \
        .build()

    
    
    request = CreateAppTableRecordRequest.builder() \
        .app_token(APP_TOKEN) \
        .table_id(TABLE_ID) \
        .request_body(AppTableRecord.builder() \
            .fields({ : text_content }) \
            .build()) \
        .build()

    
    response = client.bitable.v1.app_table_record.create(request)

    
      response.success():
        ()
        
    ()

 __name__ == :
    save_to_feishu_sdk()