Notion API接続

ドキュメント、リソース、コネクト管理ツールについては、 開発者向けサイト をご覧ください。

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

2. ワークスペースオーナーのみが、コネクトタブにアクセスしてインテグレーションを作成できます。管理者でない場合は、ワークスペース管理者に連絡するか、別のワークスペースを使用してください。

3. 下部にある独自のコネクトを開発リンクをクリックします。

4. 自分のコネクトはデフォルトのブラウザで開きます。+新規コネクトボタンをクリックします。

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

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

   

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

   

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

8. 内部コネクトの横にある ••• をクリックして、内部コネクトトークンを取得します。このトークンは、APIベースの自動化やチームが作成したワークフローのために、またはワークスペースをパートナーのプラットフォームとリンクさせるために必要です。

新しく追加されたコネクトは、最初はすべて内部コネクトです。公開コネクトに取り組んでいる開発者の方の場合、まず上記の手順に沿って内部コネクトを作成します。

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

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

• コンテンツについて

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

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

  • コンテンツの挿入

• ユーザー情報について

  • ユーザー情報なし

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

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

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

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

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

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

WebhookアクションとコネクションWebhookには、いくつかの類似点があります。どちらもトリガーがあり、サードパーティのサービスにイベントを送信できます。ただし、コネクションWebhookは以下のような、より広範な機能を提供します：

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

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

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