Skip to main content

概要

Notion ツールを使用すると、ページやデータベース、ブロックの作成・管理を含む Notion ワークスペースに関するさまざまなタスクを自動化できます。また、ページやデータベースから情報を抽出することも可能です。

主な機能

  • NOTION_SEARCH
    • 連携に共有されているページとデータソースをタイトルで横断検索。対象種別の絞り込み、最終更新順ソート、ページネーションに対応
  • NOTION_CREATE_PAGE
    • 指定した Notion ワークスペースに新しいページを作成
  • NOTION_CREATE_DATABASE_ITEM
    • 指定したデータベースに新しいアイテムを追加
  • NOTION_RETRIEVE_A_PAGE
    • 指定したページを取得
  • NOTION_RETRIEVE_DATABASE
    • 指定したデータベースを取得
  • NOTION_QUERY_DATA_SOURCE
    • データソースまたは従来のデータベースを filter / sort 付きで検索
  • NOTION_LIST_BLOCK_CHILDREN
    • ページやブロックの子ブロックを取得。必要に応じて再帰取得
  • NOTION_APPEND_BLOCK_CHILDREN
    • Notion ブロック JSON をページやブロックへ追加
  • NOTION_DUPLICATE_PAGE
    • ページの書き込み可能なプロパティと対応する子ブロック(段落、見出し、リスト、引用、ToDo、トグル、コールアウト、同期ブロック、数式、コード、テーブル、カラム、子ページ、リンクドデータベースビューなど)を再帰的にコピーして新しいページを作成。未対応のコンテンツ(Notion ホストのメディア再アップロード、リンクプレビュー、ボタン/フォーム、実体データベースの完全複製など)はスキップされ、skipped_blocks に記録されます
  • NOTION_UPDATE_PAGE_PROPERTIES
    • ページプロパティやアイコン、カバー、ロック状態を更新
  • NOTION_APPEND_IMAGE_BLOCK
    • 外部 URL または File Upload API を使って画像ブロックを追加

認証

Notion API を使用するには、ワークスペースでインテグレーションを作成する必要があります。以下の手順に従ってください:
  1. Notion Developers にアクセス
  2. 「New Integration」をクリック
  3. 必要事項を入力し、接続したいワークスペースを選択
  4. インテグレーション作成後、「Internal Integration Token」が発行されます。このトークンを使用して API リクエストを認証します。
注意:API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

例:ページやデータベースの作成と取得