動機
Notion APIにおいて、2025-09-03で破壊的変更が行われました。
開発中に古い文献を参照してしまうなどの問題があったので、プロジェクトに影響があった範囲の変更点を備忘録としてまとめます。
📣 注意： 名前の通り2025-09-03に変更されたため、それ以前に書かれた文献は古い記法である可能性が高い
変更点：DB構造の変更
旧（〜2025-09-03以前）
DB ID = Data Source ID
Database = レコード新仕様（2025-09-03〜）
DB ID ≠ Data Source ID
一つのデータベースに対して複数のデータソースを含めることが可能になった
よってどのData Sourceに対して操作するかを明示する必要が生まれた
Database
├── Data Source A
└── Data Source B
notionでデータソースを追加する操作
[ビューの操作] -> [データソースを管理する] -> [+データソースを追加]
レコード取得
database_id と data_source_id には互換性がなく、そのまま使い回しはできない
// 旧
await notion.databases.query({ database_id: "xxx" })
// 新
await notion.dataSources.query({ data_source_id: "yyy" })ページ作成
// 旧
await notion.pages.create({
parent: { database_id: "xxx" },
properties: { ... }
})
// 新
await notion.pages.create({
parent: { data_source_id: "yyy" },
properties: { ... }
})
