使用Python?SDK實(shí)現(xiàn)將數(shù)據(jù)寫入飛書多維表格

更新時間：2026年03月05日 09:32:16 作者：GalenZhang888

這篇文章主要為大家詳細(xì)介紹了如何通過?Python?代碼將文本信息自動保存到指定的飛書多維表格（Base/Bitable）中,主要包含飛書開放平臺的配置、表格授權(quán)以及環(huán)境安裝步驟,有需要的小伙伴可以了解下

一、飛書開放平臺配置

在使用代碼之前，需要先創(chuàng)建一個“機(jī)器人”身份并賦予相應(yīng)權(quán)限。

創(chuàng)建應(yīng)用：登錄飛書開放平臺，創(chuàng)建一個企業(yè)自建應(yīng)用。

配置權(quán)限：進(jìn)入應(yīng)用的“權(quán)限管理”頁面，搜索并開通以下權(quán)限（Scope）：

bitable:app （查看、評論、編輯和管理多維表格）

base:record:create （新增記錄）

二、獲取多維表格信息

代碼中需要定位到具體的表格，需要從瀏覽器地址欄中獲取以下兩個 ID。

打開目標(biāo)多維表格：使用瀏覽器訪問你需要寫入數(shù)據(jù)的表格。

提取 ID：觀察瀏覽器地址欄的 URL，格式通常如下：https://base_url/base/{app_token}?table={table_id}

App Token：緊跟在 base/ 后面的那串字符。
Table ID：URL 參數(shù)中 table= 后面的那串字符。

三、文檔授權(quán)（關(guān)鍵步驟）

僅有 API 權(quán)限是不夠的，還需要將應(yīng)用“拉入”具體的文檔中，否則會報錯 Forbidden (91403)。

在多維表格頁面右上角，點(diǎn)擊 “…”（菜單按鈕）。
選擇 “更多” -> “添加文檔應(yīng)用”。
在搜索框中輸入你在第一步創(chuàng)建的應(yīng)用名稱。
點(diǎn)擊添加，并務(wù)必勾選 “可編輯” 權(quán)限。

四、安裝環(huán)境

在本地 Python 環(huán)境中安裝飛書官方 SDK：

pip install lark-oapi

五、代碼實(shí)現(xiàn)

完成以上配置后，將 App Token、Table ID 以及應(yīng)用的 App ID 和 App Secret 填入代碼即可運(yùn)行。

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):
    # 1. 構(gòu)建 Client
    client = lark.Client.builder() \
        .app_id(APP_ID) \
        .app_secret(APP_SECRET) \
        .build()

    # 2. 構(gòu)造請求對象
    # 注意：fields 中的 key 必須與表格列名一致
    request = CreateAppTableRecordRequest.builder() \
        .app_token(APP_TOKEN) \
        .table_id(TABLE_ID) \
        .request_body(AppTableRecord.builder() \
            .fields({
                "消息內(nèi)容": text_content
            }) \
            .build()) \
        .build()

    # 3. 發(fā)起請求
    response = client.bitable.v1.app_table_record.create(request)

    # 4. 處理結(jié)果
    if not response.success():
        print(f"請求失敗, code: {response.code}, msg: {response.msg}")
        return

    print(f"保存成功! Record ID: {response.data.record.record_id}")

if __name__ == "__main__":
    save_to_feishu_sdk("內(nèi)容: 賣出：1000ETF(159629.XSHE:2.512) - 中證2000策略")

使用 requests 庫（原生 API）

import requests

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

def get_tenant_access_token(app_id, app_secret):
    """獲取訪問憑證 (tenant_access_token)"""
    url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
    headers = {"Content-Type": "application/json; charset=utf-8"}
    payload = {
        "app_id": app_id,
        "app_secret": app_secret
    }
    
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        return response.json().get("tenant_access_token")
    else:
        raise Exception(f"獲取 Token 失敗: {response.text}")

def add_record(access_token, app_token, table_id, data_fields):
    """向多維表格添加一條記錄"""
    url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records"
    
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json; charset=utf-8"
    }
    
    # 構(gòu)建請求體
    payload = {
        "fields": data_fields  # 這里的 keys 必須對應(yīng)多維表格里的列名
    }
    
    response = requests.post(url, headers=headers, json=payload)
    return response.json()

def save_to_feishu(text_content):
    try:
        # 1. 獲取 Token
        token = get_tenant_access_token(APP_ID, APP_SECRET)
        print("Token 獲取成功")
        
        # 2. 準(zhǔn)備要保存的數(shù)據(jù)
        # 注意：字典的 Key 必須完全匹配多維表格的【字段名稱】
        text_data = {
            "消息內(nèi)容": text_content
        }
        
        # 3. 寫入數(shù)據(jù)
        result = add_record(token, APP_TOKEN, TABLE_ID, text_data)
        
        if result.get("code") == 0:
            print("數(shù)據(jù)保存成功！記錄ID:", result["data"]["record"]["record_id"])
        else:
            print("保存失敗:", result)
            
    except Exception as e:
        print("發(fā)生錯誤:", e)

if __name__ == "__main__":
    save_to_feishu('內(nèi)容: 賣出：1000ETF(159629.XSHE:2.512) - 中證2000策略')

到此這篇關(guān)于使用Python SDK實(shí)現(xiàn)將數(shù)據(jù)寫入飛書多維表格的文章就介紹到這了,更多相關(guān)Python數(shù)據(jù)寫入飛書多維表格內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: