ワークスペースベースのトークンは使っていなかったので、私には問題はない。概要だけまとめるだけにする。
本日から Notion workspace の認証方法を変更する。これまでの認証は10月19日で使えなくなる。
これまで OAuth トークンはワークスペースベースだった。管理者だけが設定でき、ワークスペースごとに一つしか設定できなかった。今後、ユーザベースのトークンに移行していく。新しい認証は、管理者だけでなくメンバーも設定でき、ワークスペースに複数のトークンを利用できる。
違いをまとめた表はこちら
移行準備
この変更はパブリックインテグレーション(OAuth を経由してアクセスするもの)にのみ影響する。内部インテグレーションには影響しない。
- インテグレーションに許可されているワークスペースごとに複数の Notion API トークンが保存できていることを確認する。API トークンごとに一意であることが保証されている
bot_idに直接トークンをマップすることができる。 - トークンの上書きを避けるために、OAuth 応答で返ってきた
workspace_idをマッピングしないこと。ユーザが複数のワークスペースにインテグレーションを導入する可能性があるので、OAuth 応答のowner.user.idをマッピングしないこと。
- 全てのユーザレベルトークンが準備できたら、
&owner=userを OAuth 認証 URL (https://api.notion.com/v1/oauth/authorizeで始まるもの)に追加する。
10/19 に期待されること
10月19日は、Workspace-level トークンから User-level トークンに移行する。
owner パラメータがない場合でも、User-level 認証を実施する。Notion API Changelog まとめ