はじめに

hkob の雑記録の第446回目(通算20日目)は、3/25 に公開された Notion API の 3 つのアップデートを紹介します。

Tab block support

最初は先日ようやく実装された Tab block が早々に API で利用可能になりました。

翻訳しておきます。

Tabブロックのサポート

Tab blocks が API でサポートされるブロックタイプになりました。タブを使って、ページ内のコンテンツをラベル付きのセクションに整理できます。

読み取り: Retrieve a block と Retrieve block children は、type: "tab" と空の tab: {} オブジェクトを持つ tab ブロックを返します。コンテナ内の各タブは paragraph ブロックで、rich_text がタブのラベル、icon がタブのアイコン、children がタブの内容です。

作成: Append block children は type: "tab" ブロックを受け付けます。各タブはネストした children と任意の icon を持つ paragraph ブロックです。tab ブロックの直下の子要素にできるのは paragraph ブロックだけです。

Writable verification property

次は verification property です。こちらもアップデートできるようになりました。

同じように翻訳しておきます。

書き込み可能になった verification プロパティ

Wiki データベースページの verification プロパティを、Create page と Update page エンドポイントから設定・更新できるようになりました。state に "verified" または "unverified" を指定し、有効期限を設定する場合は任意で date オブジェクトを指定します。verified_by フィールドは実行中のインテグレーションに自動設定され、上書きできません。

Native icons and custom emoji listing

最後は Native icon やカスタム絵文字のリスト取得です。

こちらも翻訳しておきます。

ネイティブアイコンとカスタム絵文字一覧

アイコン関連の改善が2点あります。

Notion のネイティブアイコン: すべての icon フィールド（ページ、データベース、コールアウトブロック）で、新しい type: "icon" のバリアントが利用可能になりました。name と、任意の color（既定値は "gray"）でアイコンを指定します。従来はネイティブアイコンが SVG URL を持つ type: "external" として返されていましたが、現在は構造化された icon 形式で返されます。

カスタム絵文字の一覧取得: 新しい List custom emojis エンドポイント（GET /v1/custom_emojis）で、ワークスペースのカスタム絵文字をカーソルページネーション付きで取得できます。完全一致検索用に、任意で name フィルタも指定できます。

ネイティブアイコンとカスタム絵文字一覧

アイコン関連の改善が2点あります。

Notion のネイティブアイコン: すべての icon フィールド（ページ、データベース、コールアウトブロック）で、新しい type: "icon" のバリアントが利用可能になりました。name と、任意の color（既定値は "gray"）でアイコンを指定します。従来はネイティブアイコンが SVG URL を持つ type: "external" として返されていましたが、現在は構造化された icon 形式で返されます。
カスタム絵文字の一覧取得: 新しい List custom emojis エンドポイント（GET /v1/custom_emojis）で、ワークスペースのカスタム絵文字をカーソルページネーション付きで取得できます。完全一致検索用に、任意で name フィルタも指定できます。