Notion API接続

Notionから個人アクセストークンを管理できます。設定から開発者モードをオンにし、サイドバーの開発者セクションから個人アクセストークンを開いてください。ドキュメント、リソース、コネクション管理ツールについては、デベロッパーハブをご覧ください。

管理者トークンをお探しですか？このページのトークンは1つのワークスペース内で機能し、ページコンテンツを処理します。エクスポート、訴訟ホールド、ユーザーのログアウトといった組織の管理者作業を実行する必要がある場合は、エンタープライズ組織向けの管理者APIをご覧ください。

1. 左のサイドバーで 設定 から、コネクト タブにアクセスします。

2. ワークスペースオーナーのみが 接続 タブにアクセスし、統合を作成できます。管理者でない場合は、ワークスペース管理者に連絡するか、別のワークスペースを使用してください。

3. 開発者モードをオンにし、サイドバーの開発者セクションから個人アクセストークンを開いてください。

4. + 新規コネクションをクリックします。

5. 接続の 名前 を入力します。オプションで、ロゴ として使用する画像をアップロードできます。

6. ドロップダウンメニューを使用して、このコネクトを使用したい 関連ワークスペース を指定します。

   

   備考： デスクトップアプリで使用しているアカウントで、WebでもNotionにログインしていることを確認してください。そうでない場合は、正しいアカウントとワークスペースが表示されません。

   

7. 内部接続が作成されました！ワークスペースの 設定 メニュー → 接続 にこの接続が表示されます。

8. 内部接続の隣の ••• メニューをクリックして、内部接続トークンを取得します。このトークンは、APIベースのオートメーションやチームが作成したワークフロー、またはワークスペースをパートナーのプラットフォームとリンクさせるために必要です。

新たに追加された接続は、最初はすべて内部接続になります。パブリック接続に取り組んでいる開発者の方の場合、まず上記の手順に沿って内部接続を作成します。

その後、 開発者ガイド の手順に沿って公開コネクトに変換してください。

アプリの設定の中で、開発者はユーザーに要求するアクセス権限のレベルを選択できます。

• コンテンツについて

  • コンテンツの読み取りのみ

  • コンテンツの書き込みのみ

  • コンテンツの挿入

• ユーザー情報について

  • ユーザー情報なし

  • ユーザー情報の読み取り（ユーザーのメールアドレスは除く）

  • ユーザー情報の読み取り（メールアドレスを含む）

ユーザーが接続をインストールすると、このアクセスレベルが表示されます。また、接続が追加されたページの 共有 メニューにも表示されます。 ワークスペースへの接続のインストールについて詳しくはこちら →

コネクションWebhookを使用すると、コネクションがNotionワークスペースの変更をリアルタイムでモニターし、対応できるようになります。

コネクトと共有されているページやデータベースに変更が発生すると 、Notionは自動的にWebhookエンドポイントに通知を送信します。これにより、コネクトは他のツールを即座に更新、自動化されたタスクの実行、最新の変更を表示、などができます。

手順については、 開発者向けドキュメントをご覧ください。

Webhookアクション とコネクションWebhookには共通点があり、どちらもトリガーを持ち、サードパーティサービスにイベントを送信できます。ただし、コネクションWebhookの方がより幅広い機能を提供します。

• 複数のワークスペースにまたがるアクティビティを監視できます。

• 無制限のアクションを処理できます。

これに対し、Webhookアクションは、よりシンプルなユースケース向けに設計されており、限られたトリガーセットを使用したデータベースオートメーションを通じて構成されます。