如何通过Smartsheet API为下拉列表列添加带多选选项的新行

要正确设置多选下拉列的多个选中选项，必须使用objectValue结构指定MULTI_PICKLIST类型，并确保multiPickList.values是字符串数组。以下是具体实现方式：

正确的请求结构 #

发送POST /sheets/{sheetId}/rows请求时，单元格的JSON结构应如下：

{
  "rows": [
    {
      "cells": [
        {
          "columnId": 你的列ID,
          "objectValue": {
            "objectType": "MULTI_PICKLIST",
            "multiPickList": {
              "values": ["test", "test2", "test3"]
            }
          }
        }
      ]
    }
  ]
}

避坑要点 #

• 不要使用value字段传递空格分隔的文本（比如"value": "test test2 test3"），这会被识别为单一文本值，无法拆分为独立选项
• 确保multiPickList.values是字符串数组，每个元素对应一个要选中的选项
• 确认目标列的类型为「多选下拉列表（Multi-Select Picklist）」，普通单选用这个格式会报错
• 检查字段拼写：multiPickList和values的大小写、拼写必须完全符合API要求

排查常见报错 #

如果仍然收到Required object attribute(s) are missing from your request: multiPickList.values[]错误：

• 验证columnId是否对应正确的多选列
• 检查values数组里的选项是否与列定义的选项完全匹配（包括大小写、空格）
• 排查代码中的JSON序列化问题，确保数组结构没有被转为字符串或其他格式

内容的提问来源于stack exchange，提问作者Eric Olsen