如何通过Fusion Query向Foundry Slate的Fusion Sheet写入数组数据

开发者阿泽

2026-8-6

解决Fusion Sheet API写入数组类型列的问题

正确的Payload格式：不要直接传原生数组，也不要传公式字符串，需要在请求体中为数组列指定类型标识，用结构化对象传递。示例Payload如下：

{
  "rows": [
    {
      "fields": {
        "常规列": "测试文本",
        "数组列": {
          "type": "array",
          "value": ["a", "b", "c"]
        }
      }
    }
  ]
}

问题根源解析：
- 直接传原生数组会被API判定为参数结构不合法，触发「Invalid argument」错误；
- 传入=array('a','b')字符串时，API会默认按普通文本存储，不会自动解析公式生成数组，必须通过明确指定类型的方式告知API这是数组值。
验证方法：写入完成后，通过Fusion Query或API读取该字段会返回标准数组格式；在Fusion Sheet界面查看对应单元格，会显示数组内容而非公式文本。