使用智能表创建多下拉列 api

Creating multi drop down columns using the smartsheet api

最近,智能表中添加了一种新类型的列:多下拉列表:

是否有使用 api 创建此类列的解决方案?

是否计划 api 的新版本?

从 10 月 1 日起,您实际上可以创建一个支持新的多下拉功能的列。文档有点落后。

  1. 如果您还没有列,则必须先添加一列。
  2. 获得 columnId 后,您可以发送更新列请求并将 "type" 指定为 "MULTI_PICKLIST"。

要在执行 GET /sheets/{sheetId} 或 GET /{columnId} 时检索正确的类型,您必须使用查询参数 ?level=3&include=objectValue。

可以通过 API!

创建一个 Dropdown (multi select)

为了简要解决 TEXT_NUMBER 问题,此类型用于向后兼容。如果您不知道 ?level=2&include=objectValue 后缀,响应将 return 一个 TEXT_NUMBER 列类型以避免破坏任何未设置为处理新列类型的现有客户端。


在以下示例中,双括号变量代表您的目标:

{{environment}} 类似于 https://api.smartsheet.com/2.0/

{{sheetId}} 是一个 sheet 形式的 ID 6264126827992742

{{columnId}}2641268279927426

形式的主列的 ID

{{columnId2}}6412682799274262

形式的多选列表列的 ID

将类型为 MULTI_PICKLIST 的列添加到现有的 sheet:

POST: {{environment}}/sheets/{{sheetId}}/columns/

{
  "title": "I'm a new multi picklist column",
  "type":"MULTI_PICKLIST",
  "index": 1,
  "options": ["opt1","opt2","opt3"]
}

要在全新的 sheet 上创建一个列,此示例将创建一个包含主列的 sheet、一个 MULTI_PICKLIST 列,然后添加包含一些数据的行.

然后它将获得 sheet 使用级别 2 以避免向后兼容 TEXT_NUMBER 类型。

要创建具有 MULTI_PICKLIST 列的 sheet:

POST: {{environment}}/sheets

{
  "name":"API PL Sheet",
  "columns":
  [
    {
      "title":"My primary Column",
      "primary":true,
      "type":"TEXT_NUMBER"
    },
    {
      "title":"My multi select column",
      "type":"MULTI_PICKLIST", 
      "options":["options","in","this","form"]
    }
  ]
}

要在此sheet上添加一行:

POST: {{environment}}/sheets/{{sheetId}}/rows?include=objectValue

[
  {
    "toTop": true,
    "cells":
    [
      {
        "columnId":{{columnId}}, 
        "value": "1"
      },
      {
        "columnId":{{columnId2}}, 
        "objectValue": 
        {
          "objectType":"MULTI_PICKLIST",
          "values":["in", "form"]
        }
      } 
    ]
  }
]

要查看具有 MULTI_PICKLIST 对象值的 sheet:

获取:{{environment}}/sheets/{{sheetId}}?level=2&include=objectValue


如果不包含 ?level=2&include=objectValue 后缀,则 JSON 响应的列将显示为 TEXT_NUMBER 类型。


最后一点,不同的终点组需要不同的水平。它们如下:

  • GET 单元格历史是 2 级

  • GET 表格是第 2 级

  • GET 行是级别 2

  • GET 列为 2 级

  • POST 排序为 2 级

  • GET Sights(仪表板)是级别 3

  • GET 报告是 3 级