飞书多维表格数据同步

⚠️ 前置条件

• ✅ 获取 app_token：从多维表格 URL 或列表 API 获取
• ✅ 获取 table_id：从多维表格的表格列表中获取
• ✅ 字段类型：必须完全匹配（文本=1，数字=2，日期=5，人员=11，等等）

📋 快速参考

🛠️ 同步模式

1. 单向同步（源 → 目标）

// 步骤 1：读取源数据
{
  "action": "list",
  "app_token": "source_token",
  "table_id": "source_table",
  "page_size": 500
}

// 步骤 2：转换并写入目标
{
  "action": "batch_create",
  "app_token": "dest_token", 
  "table_id": "dest_table",
  "records": [
    {"fields": {"字段A": "值1", "字段B": "值2"}}
  ]
}

2. 双向同步（含冲突解决）

通过唯一标识符比对记录，并处理冲突：

// 同步伪代码：
// 1. 分别拉取两个多维表格数据
// 2. 按唯一字段（例如：任务ID）进行比对
// 3. 若源端更新：更新目标端
// 4. 若目标端更新：更新源端（或跳过）
// 5. 输出同步结果报告

{
  "action": "list",
  "app_token": "token",
  "table_id": "table",
  "filter": {
    "conjunction": "and",
    "conditions": [{"field_name": "同步状态", "operator": "is", "value": ["未同步"]}]
  }
}

3. 从 CSV 导入

将 CSV 转换为多维表格记录：

任务名称,负责人,截止日期,优先级
任务A,张三,2026-04-01,高
任务B,李四,2026-04-02,中

{
  "action": "batch_create",
  "app_token": "Mxxx",
  "table_id": "Txxx",
  "records": [
    {"fields": {"任务名称": "任务A", "负责人": [{"id": "ou_xxx"}], "截止日期": 1743446400000, "优先级": "高"}},
    {"fields": {"任务名称": "任务B", "负责人": [{"id": "ou_yyy"}], "截止日期": 1743532800000, "优先级": "中"}}
  ]
}

4. 定时同步标记

使用专用字段追踪同步状态：

{
  "action": "batch_update",
  "app_token": "Mxxx",
  "table_id": "Txxx",
  "records": [
    {"record_id": "rec_xxx", "fields": {"同步状态": "已同步", "同步时间": 1743446400000}}
  ]
}

💰 定价

📝 示例

用户输入：“把 A 表格的任务同步到 B 表格，只同步未完成的任务”

执行步骤：

1. 使用「未完成」筛选条件，从源表格中列出记录
2. 将记录转换为目标表格的字段结构
3. 批量创建或更新目标表格中的记录
4. 将源表格中对应记录标记为「已同步」

🔧 字段类型参考