【非エンジニア向け】API 経由で Notion にメモを送信する方法（JavaScript SDK の使い方）
こんにちは。Notion アンバサダーの円谷です。
今回の記事では非エンジニアの方に向けて、Notion API の簡単な使い方を紹介したいと思います。非エンジニアの方には少しハードルが高いように思われる Notion API ですが、一度仕組みをインプットしてしまえばかなり応用が効く技術なので、ぜひチャレンジしてみてもらえればと思います。
Notion API を使うことで、僕が個人開発している Fast Notion や、Twi Notion などのアプリケーションを作ることができたり、Notion を CMS にしたブログの開発、Alfred と連携して Mac で高速にメモを取ることができるワークフローを構築したりすることができるようになったりします。
今回の記事では、サンプルとして、自分の手元の PC からご自身の Notion データベースにデータを追加する例を取り上げたいと思います。Notion がオフィシャルで公開している JavaScript SDK をもとに、サンプルコードを作成していきます。
Notion API について （できること・できないこと）
まずはじめに、ざっくりと Notion API のインプットをしましょう。
Notion API は昨年 2021/5/15 にパブリックベータ版としてリリースされたばかりの新しい機能です。2022/02/06 現在まだ パブリックベータ版という扱いではあるものの、リリースされて半年以上安定稼働をしており、僕自身も様々なアプリケーションと連携させて使うことができています。
👀 Notion API の Reference ページがいつの間にか見やすくなってる（良い）https://t.co/3h8dSGG8vQ pic.twitter.com/peZ5llvu0r
— Yuji Tsuburaya (@___35d) February 3, 2022
Notion API を使うことで、Notion のアプリケーションやブラウザを開くことなく、コードベースで Notion を操作することができるようになります。具体的には、データベースのデータ取得や、ページ作成、テキストの送信、等の操作ができます。
💁♀️ 拙作アプリの Fast Notion や Twi Notion はテキスト送信の API、自作ブログはデータ取得の API をそれぞれ実行することで実現しています。
画像を含めたのファイルのアップロード機能には対応していないのですが、それ以外の基本的な操作は一通り Notion API 経由で行うことができます。詳しくは公式ドキュメントを参照いただければと思います。
ざっくりと Notion API のインプットができたところで、それでは実際に Notion API の操作をしていきましょう。
データベースにデータを追加するサンプルコードと簡単な解説
ソースコードは以下になります。30行弱の簡単な TypeScript のファイルで、Notion JavaScript SDK を使うと、このようにシンプルなコードで表現することができます。
👩💻 note マガジン用に Notion API のサンプルを作ってる。Notion API 使うとコードから Notion のデータを操作することができるようになります。 pic.twitter.com/IPdcQDeWV3
— Yuji Tsuburaya (@___35d) February 6, 2022
この記事が気に入ったらサポートをしてみませんか？