インテグレーション機能
インテグレーション機能
すべてのインテグレーションには、インテグレーションが Notion ワークスペースで実行および表示できることを強制する機能が関連付けられています。これらの機能を組み合わせると、インテグレーションが呼び出すことができる API エンドポイント、およびそれらが表示できるコンテンツとユーザー関連情報が適用されます。インテグレーションの機能を設定するには、認証ガイドを参照 するか、https://www.notion.so/my-integrationsに移動します。
機能設定画面のスクリーンショット。
📘インテグレーションがページに追加された場合、インテグレーションはページの子にアクセスできます
インテグレーションが Notion ページまたはデータベースへのアクセスを受け取ると、そのリソースとその子の両方に対して読み取りと書き込みを行うことができます。
コンテンツ機能
コンテンツ機能は、インテグレーションがAPI を介してデータベース オブジェクト、ページ オブジェクト、およびブロック オブジェクトと対話する方法に影響します。さらに、これらの機能は、API 応答でインテグレーションに公開される情報に影響します。エンドポイントの望ましい動作に必要な機能を確認するには、API リファレンスを使用してください。
- コンテンツの読み取り: この機能により、Notion ワークスペース内の既存のコンテンツを読み取るためのインテグレーションアクセスが提供されます。たとえば、この機能のみを使用したインテグレーションでは、データベースの取得を呼び出すことはできますが、データベースの更新を呼び出すことはできません。
- コンテンツの更新: この機能は、Notion ワークスペース内の既存のコンテンツを更新するためのインテグレーション権限を付与します。たとえば、この機能のみのインテグレーションでは、更新ページエンドポイントを呼び出すことはできますが、新しいページを作成することはできません。
- コンテンツの挿入: この機能により、Notion ワークスペースに新しいコンテンツを作成するためのインテグレーション権限が与えられます。この機能は、完全なオブジェクトを読み取るためのアクセス権をインテグレーションに付与しません。たとえば、この機能のみを使用したインテグレーションでは、ページを作成
できます が、既存のページを更新することはできません。
インテグレーションでは、これらのコンテンツ機能を任意に組み合わせることができます。
コメント機能
コメント機能は、インテグレーションがページまたはブロックのコメントと対話する方法を決定します。
- コメントの読み取り: この機能により、インテグレーションにNotion ページまたはブロックからコメントを読み取る権限が与えられます。
- コメントの挿入: この機能により、ページまたは既存のディスカッションにコメントを挿入するインテグレーション権限が付与されます。
ユーザー機能
インテグレーションでは、Notion API からユーザー オブジェクトが返される方法に影響を与える、さまざまなレベルのユーザー機能を要求できます。
- ユーザー情報なし: このオプションを選択すると、インテグレーションでユーザーに関する情報が要求されなくなります。ユーザー オブジェクトには、名前、プロフィール画像、メール アドレスなど、ユーザーに関する情報は含まれません。
- メール アドレスを含まないユーザー情報: このオプションを選択すると、ユーザー オブジェクトには、名前やプロフィール画像など、ユーザーに関するすべての情報が含まれますが、メール アドレスは省略されます。
- ユーザー情報と電子メール アドレス: このオプションを選択すると、名前、プロフィール画像、電子メール アドレスなど、ユーザーに関するすべての情報がユーザー オブジェクトに含まれるようになります。
機能の動作とベスト プラクティス
インテグレーションの機能がユーザーの機能に取って代わることはありません。ユーザーがインテグレーションを追加したページへの編集アクセス権を失った場合、インテグレーションが作成された機能に関係なく、そのインテグレーションにも読み取りアクセスのみが付与されます。
パブリックインテグレーションの場合、ユーザーがインテグレーションで最後に認証されてから時間内に機能が変更された場合、ユーザーはインテグレーションで再認証する必要があります。
インテグレーション機能の設定の詳細については、承認ガイドを参照してください。
一般に、インテグレーションが機能するために必要な最小限の機能を要求します。要求する機能が少ないほど、ワークスペース管理者がインテグレーションをインストールできる可能性が高くなります。
例えば：
- インテグレーションがデータを Notion に取り込む (新しいページを作成する、またはブロックを追加する) だけである場合、インテグレーションにはコンテンツの挿入機能のみが必要です。
- インテグレーションがデータを読み取って Notion からエクスポートする場合、インテグレーションにはコンテンツの読み取り機能のみが必要です。
- インテグレーションがページまたは既存のブロックのプロパティを更新するだけの場合、インテグレーションにはコンテンツの更新機能のみが必要です。