開示?
開示?
原題
Releasing Notion-Version 2022-02-22
日付
Feb 26, 2022
Number
41
前のリリース日(最新)
リリース間隔(日)
作成日
Feb 26, 2022 04:23 AM
前のリリース
タグ
IMPROVED
経過日数
約半年ぶりの後方互換性のない新バージョンです(2021-8-16 → 2022-02-22)。日付的に覚えやすいバージョンですね。データベースの検索用のプロパティ名とオブジェクトのプロパティ名を揃えたところが大きいです。かなり分かりやすくなりました。
概要説明
我々は互換性のない変更のみをバージョン分けしているため、一般的にはアップグレードしなくても新機能にはアクセスすることが可能です。リクエストごとにバージョンヘッダを付け替えできるので、段階的にアップグレードして、最新版に到達することができます。
我々は以下のような後方互換性のない変更を加えた Notion-Version
2022-02-22 をリリースします。- ブロック内の
textはrich_textに名称変更されました。これはデータベースのプロパティタイプと一致させるためです。
- クエリデータベースのフィルタの変更
-
phone_numberとrich_textプロパティによってフィルタリングされる際、phoneとtextはサポートされなくなりました。代わりに、phone_numberとrich_textを使ってください。 rollupクエリデータベースフィルタはtextキーワードを受け入れなくなりました。代わりにrich_textを使ってください。formulaクエリデータベースはtextキーワードを受け入れなくなりました。代わりにstringを使ってください。
property_itemオブジェクトはtype,next_url, とidを返すようになりました。
- List Databases API エンドポイントは非推奨になりました。
コンテントブロック内の text プロパティは rich_text に変更されました。
データベースプロパティタイプとの一貫性を保つために、
text プロパティは rich_text に変更しました。これは以下、ブロックタイプに影響します。→ paragraph, heading_1, heading_2, heading_3, callout, quote, bulleted_list_item, numbered_list_item, to_do ,toggle, code ,template.これは以前の
text プロパティです。これは更新された
rich_text プロパティです。データベースクエリフィルタの変更
phone and text no longer supported
Version 2022-02-22 では、クエリデータベースエンドポイントでの、
phone と text プロパティフィルタをサポートしなくなりました。データベースのプロパティタイプとの一貫性を保つために、代わりに phone_number と rich_text プロパティを使用します。より具体的に、このデータベースクエリは検証エラーを投げるようになります。
このデータベースクエリは成功します。
rollup プロパティは text の代わりに rich_text を受け付けます。
ロールアッププロパティは
text の変わりに rich_text キーワードで構成する必要があります。具体的に、ロールアッププロパティが以下のような形でレンダリングされているとします。このフィルタは version 2022-02-22 では機能しなくなります。
代わりに、以下のように記述します。
formula property filters accept string instead of text
フォーミュラプロパティフィルタは、
text キーワードではなく string キーワードを使用して構築する必要があります。具体的には、ページの数式プロパティが以下のように構築されているとします。このフィルタは Version 2022-02-22 では機能しなくなります。
代わりに以下のように記述してください。
プロパティリストアイテムは型を持つようになりました
プロパティリストアイテムの型は、
property_item になりました。 ロールアップ集計は、その型の中に記載されるようになりました。さらに id フィールドと next_url フィールドが追加され、次のフェッチができるようになります。これは以前の
rollup property_item のリストです。こちらは新しい
rollup property_item です。リストデータベースエンドポイントは非推奨になりました
全ての Databases の一覧を取得するリストエンドポイントはこのバージョンから削除されます。この機能の代わりに、 Search API を利用することができます。リストデータベースエンドポイントは明示的に共有されたページのみを検索しますが、検索エンドポイントは共有されたページ内の子ページも返します。
