NotionAPI ／「select」「multi_select」に、存在しない選択肢を動的に追加できるようになったので試してみる。

本日、NotionAPIでselectプロパティ、multi_selectプロパティへ選択肢を動的に新規追加できるようなったとアナウンスがあったので早速試してみました。

⚙️ New API functionality!

You can now dynamically add new option values for select and multi-select properties via the Create and Update Page endpoints, when these options didn't exist in the database already.

More here: https://t.co/86B6xqLTSk pic.twitter.com/CfodPKsmHi
— Notion API (@NotionAPI) June 16, 2021

先に結論です。

selectプロパティ、multi_selectプロパティともに、
これまでは、送信した選択肢の登録がない場合にエラーとなっていました。
これからは、エラーとはならず、選択肢を新規追加しつつ成功するようなりました。
送信データは変わっていません。単純に便利になった感じです。

では試していきます。

テスト用のデータベーステーブルの作成

selectプロパティへ動的に選択肢を新規追加

いい感じです。今まではこれがエラーになっていました。
送信データはこんな感じ。
同じAPIをもう一度呼んでもエラーになることはありません。

{
  "properties": {
    "セレクト": {
      "select": {
        "name": "追加オプション1" // 新規追加
      }
    }
  }
}

multi_selectプロパティへ動的に選択肢を新規追加

送信データはこんな感じ。同じく今まではこれがエラーになっていました。
同じAPIをもう一度呼んでもエラーになることはありません。

{
  "properties": {
    "マルチセレクト": {
      "multi_select": [
        {
          "name": "追加オプション1"// 新規追加
        },
        {
          "name": "追加オプション2"// 新規追加
        }
      ]
    }
  }
}

すでに登録されている選択肢（↑で動的追加したもの）を選んで更新（レコード2）

送信データ

{
  "properties": {
    "セレクト": {
      "select": {
        "name": "追加オプション1" // 既存
      }
    },
    "マルチセレクト": {
      "multi_select": [
        {
          "name": "追加オプション1" // 既存
        },
        {
          "name": "追加オプション2" // 既存
        }
      ]
    }
  }
}

multi_selectプロパティへ動的に選択肢を新規追加しつつ、すでに登録されている選択肢（↑で動的追加したもの）を選んで更新（レコード3）

※selectは選択肢1つなので、既存のものがあればそれを選択、なければ新規登録となります。

送信データ

{
  "properties": {
    "マルチセレクト": {
      "multi_select": [
        {
          "name": "追加オプション1" // 既存
        },
        {
          "name": "追加オプション2" // 既存
        },
        {
          "name": "追加オプション3" // 新規追加
        }
      ]
    }
  }
}

想定通り動いていました。
便利になってありがたいかぎりです。

公式のChangelogです。