【Notion API】最短で取得するNotionデータベース【RTA】
Notion API経由でデータベースの値を取得する『Notion DB(バグなし)Any% RTA』、始めていきます。
RTAとは、リアルタイムアタック（Real Time Attack）の略です。
ゲームスタートからクリアまでの実時間（時計で計測した現実の所要時間）の短さを競います。
手順をご紹介していきましょう。
準備
使用するものは二つ。
- Notion
- cURLコマンドを実行できるアプリケーション（POSTMAN、
コマンドプロンプト、PowerShell、ターミナル、シェル、コンソール…）
（2023/2/28 追記）Linux or Mac OSでの実行がおすすめです。Windowsの場合は注意点が多いので、POSTMANの使用をおすすめします。 WSLでもOKです。慣れている方はお好みの環境でどうぞ。
Notionアカウントの作成は、Notion アプリもしくはhttps://www.notion.so/からどうぞ。
それではタイムアタックを始めます。タイマースタートです⏱
レギュレーション
データベースIDの取得
まずは自分のアカウントにログインして、データベースを作成します。
例えばこんな感じで。
ビューのオプション（三点リーダ）から「ビューのリンクをコピー」してどこかに保管しておいてください。
このリンクはhttps://www.notion.so/hogehogehoge?v=hugahugahugaという形式になります。
"?v="より前のhogehogehogeをビューのIDとして使用します。
必ずデータベースに対して管理者権限のあるアカウントでログインしてください。
個人のアカウントで普通にデータベースを新規作成すれば、とくに問題は起こらないと思います。
インテグレーションの作成
Notionにはインテグレーション（コネクト）というものがあります。
お気に入りのツールをNotionにつなげる
と公式ページでは説明されており、Github、Slack、Dropboxなどのインテグレーションが公式から提供されています。
VSCodeやChromeブラウザの拡張機能、npmのパッケージのようなものでしょうか？
そんなインテグレーションですが、Notion APIを使用するには、自分専用のインテグレーションを作成する必要があります。
ブラウザからポチポチと設定していくだけですので、作り方は非常に簡単です。
Notionにログインして、インテグレーション管理ページにアクセスします。
https://www.notion.so/my-integrations
「新しいインテグレーションを作成する」を押して、新規インテグレーション作成画面に進んでください。
基本情報を入力する画面が表示されますので、名前を入力します。
「関連ワークスペース」は紐づけたいデータベースのあるワークスペースを選択してください。
「コンテンツの権限」は「コンテンツを読み取る」に必ずチェックを付けておいてください。他の項目はなんでもいいです。
すべて設定したら、「送信」を押してください。
シークレットトークンが発行されます。
こいつはBearer tokenに設定する値です。「secret_」も含めて文字列をコピーしておいてください。
APIを叩く
ターミナルなどで以下のコマンドを実行してください。
Notion-Versionの値は最新のバージョンを指定してください。
curl --location --request GET 'https://api.notion.com/v1/databases/(ビューのID)' \
--header 'Notion-Version: 2021-08-16' \
--header 'Authorization: Bearer (シークレットトークン)'
こんなレスポンスが返ってきたら成功です。データベースの値がJSON形式で取得できました。
{
"object": "database",
"id": "xxxxx",
"cover": null,
"icon": null,
"created_time": "2022-09-02TxxxxxZ",
"created_by": {
"object": "user",
"id": "xxxxx"
},
"last_edited_by": {
"object": "user",
"id": "xxxxx"
},
"last_edited_time": "2022-09-03TxxxxxZ",
"title": [
{
"type": "text",
"text": {
"content": "しろたんとおともだち",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "しろたんとおともだち",
"href": null
}
],
"description": [],
"is_inline": true,
"properties": {
"どうぶつ": {
"id": "xxxxx",
"name": "どうぶつ",
"type": "select",
"select": {
"options": [
{
"id": "xxxxx",
"name": "あざらし",
"color": "default"
},
{
"id": "xxxxx",
"name": "らっこいぬ",
"color": "yellow"
},
{
"id": "xxxxx",
"name": "アコヤ貝",
"color": "blue"
},
{
"id": "xxxxx",
"name": "ペンギン",
"color": "gray"
}
]
}
},
"なまえ": {
"id": "title",
"name": "なまえ",
"type": "title",
"title": {}
}
},
"parent": {
"type": "page_id",
"page_id": "xxxxx"
},
"url": "https://www.notion.so/xxxxx",
"archived": false
}
無事にデータを取得できました。
ここでタイマーストップです⏱
記録は21分13秒でした。慣れればもっとタイムが縮まりそうです。
レギュレーションにも改善の余地があるかもしれません（?）
完走した感想
公式は「入門」と書いていますが、初心者向けの記事としては少しハードルが高く感じました。ExcelやスプレッドシートからNotion DBにたどり着く方、結構いるのでは...？
Notionデータベースだと嬉しい場面って、わざわざRDBやMongo DBを建てるまでもない、実験的な作業だと思うので。NotionのGUIからデータベースの作成・更新・削除を実施→API経由で取得できるので、非常に便利なサンドボックスだと思います。
GETやらPOSTなどのHTTPメソッドについて知りたい方はMozillaの記事もご参照ください。
お気に入りのゲームでRTAをやってみたい方は、以下のサイトがおすすめです。
すでに、そのゲームの先駆者たちによる「学会」が設立されているかも知れません。ぜひ検索してみてください。
Notion推しのそこのあなた！同担大歓迎です！Notion DB学会でまたお会いしましょう！！！
- この記事を共有する
