Notion API接続
NotionのAPIを使用すれば、内部コネクトをカスタマイズして作成できます。Notionのワークスペースに弊社パートナーのプラットフォームをリンクするには、内部コネクトトークンが必要な場合があります。以下で詳しい手順を解説します 🏗
ドキュメント、リソース、コネクト管理ツールについては、 開発者向けサイト をご覧ください。
備考： ワークスペースオーナーは、ワークスペース内のすべてのコネクトを管理します。詳しくはこちら →
左のサイドバーで
設定から、コネクトタブにアクセスします。ワークスペースオーナーのみが、
コネクトタブにアクセスしてインテグレーションを作成できます。管理者でない場合は、ワークスペース管理者に連絡するか、別のワークスペースを使用してください。下部にある
独自のコネクトを開発リンクをクリックします。自分のコネクトはデフォルトのブラウザで開きます。
+新規コネクトボタンをクリックします。コネクトの
名前を入力します。オプションで、ロゴとして使用する画像をアップロードできます。ドロップダウンメニューを使用して、このコネクトを使用したい
関連ワークスペースを指定します。備考： デスクトップアプリで使用しているアカウントで、WebでもNotionにログインしていることを確認してください。そうでない場合は、正しいアカウントとワークスペースが表示されません。
内部接続が作成されました！ワークスペースの
設定メニュー→接続にこのインテグレーションが表示されます。内部コネクトの横にある
•••をクリックして、内部コネクトトークンを取得します。このトークンは、APIベースの自動化やチームが作成したワークフローのために、またはワークスペースをパートナーのプラットフォームとリンクさせるために必要です。
注： 内部コネクトはワークスペース固有であるため、関連付けられているワークスペースを変更するには、新規コネクトを作成する必要があります。
新しく追加されたコネクトは、最初はすべて内部コネクトです。公開コネクトに取り組んでいる開発者の方の場合、まず上記の手順に沿って内部コネクトを作成します。
その後、 開発者ガイド の手順に沿って公開コネクトに変換してください。
アプリの設定の中で、開発者はユーザーに要求するアクセス権限のレベルを選択できます。
コンテンツについて
コンテンツの読み取りのみ
コンテンツの書き込みのみ
コンテンツの挿入
ユーザー情報について
ユーザー情報なし
ユーザー情報の読み取り（ユーザーのメールアドレスは除く）
ユーザー情報の読み取り（メールアドレスを含む）
ユーザーがコネクトをインストールすると、このアクセスレベルが表示されます。また、コネクトが追加されたページの共有メニューにも表示されます。ワークスペースへのコネクトのインストールについて詳しくはこちら →
コネクションWebhookを使用すると、コネクションがNotionワークスペースの変更をリアルタイムでモニターし、対応できるようになります。
コネクトと共有されているページやデータベースに変更が発生すると 、Notionは自動的にWebhookエンドポイントに通知を送信します。これにより、コネクトは他のツールを即座に更新、自動化されたタスクの実行、最新の変更を表示、などができます。
コネクションWebhookを設定
手順については、 開発者向けドキュメントをご覧ください。
現在、コネクションWebhookは次の通知をサポートしていません：
ユーザーに関する変更（ワークスペースのメンバーシップの変更、メールアドレスや名前の更新、権限の変更を含む）。
ワークスペースとチームスペースの設定の変更。
これらのタイプの通知については、代わりに 監査ログを使用してください。
WebhookアクションとコネクションWebhookの比較
WebhookアクションとコネクションWebhookには、いくつかの類似点があります。どちらもトリガーがあり、サードパーティのサービスにイベントを送信できます。ただし、コネクションWebhookは以下のような、より広範な機能を提供します：
複数のワークスペースにまたがるアクティビティを監視できます。
無制限のアクションを処理できます。
これに対し、Webhookアクションは、よりシンプルなユースケース向けに設計されており、限られたトリガーセットを使用したデータベースオートメーションを通じて構成されます。
