Notion API 活用術 改訂作業(2) : hkob の雑記録 (337)

はじめに

hkob の雑記録の第337回目は、Section-003 までの修正を行なっていきます。本記事は2025年ユカスタマスの3日目(2023年ユカスタマスの734日目)の記事になります。

P5. 本書について

「執筆時の動作環境」は最終的に改訂版を出すとなった時のバージョンを記載します。特に NotionRubyMapping については、執筆している間に不具合などを修正がありそうで、今後もさらにバージョンアップしそうです。また、一番下の「サンプルについて」におけるテンプレートへのリンクは、今では自由にリンク名を設定できるので、以下のようにする予定です。今後もこの内容を修正していきます。これは SECTION-002 のサンプルテンプレートの複製も同様です。

hkob.notion.site

SECTION-003 インテグレーションキーの作成と取得

P14 のインテグレーションのページはページ構成が完全に変わってしまっているので、URL 自体も変更になっていました。

www.notion.so

まず、インテグレーションのトップページの画像を変更します。

トップページの画像

新しいインテグレーションの作成方法も変更になっています。以前は、最初のページで権限などまですべて設定していましたが、最初の画面では名前・利用するワークスペース・種類のみとなりました。また、以前は種類は保存後に変更する形でした。

新しいインテグレーション

保存後の画面も変更になっています。これに合わせて文面も変更しています。また表記もトークンではなく、内部インテグレーションシークレットとなっています。また、当時はトークンの接頭子が secret_ となっていましたが、現在は ntn_ になっているのでその説明を変更しています。

保存後の画面

このページを下にスクロールすると許可できる機能の設定画面となっています。

許可できる機能

P18 の「インテグレーションキーの取得」も右ボタンで出現するメニューが変更になっているので、スクリーンショットを撮り直しました。

インテグレーションキーの取得

テンプレートのインテグレーションキーの保存場所にも secret_ の文言が残っているので、スクリーンショットを撮り直しました。

インテグレーションキーの保存場所

P19 の「インテグレーションのコネクト」は「インテグレーションの接続」にタイトルを変更しました。この画面内ではコネクトという言葉を使用していないためです。設定画面ではまだコネクトという文言を使っているのですが。

インテグレーションの接続

接続後のダイアログもアクセス権限の確認が追加されていたので、スクリーンショットを変更しました。

接続後のダイアログ

接続後の確認画面もコネクトではなく接続になっているので、スクリーンショットを変更しています。

接続後の確認画面

本文変更について

前回の記事ではサジェストモードを使ったらいいのではと記載しました。しかし、サジェストモードは意外と画像変更や移動などの制約が多く使いにくかったです。そこで、今回編集するにあたりサジェストモードではなく、以下のように「取り消し線・赤字変更・追加部をまとめてコメント」のセットで記録しました。これだと Cmd-Shift-S(取り消し)、Cmd-Shift-H (赤字変更)、 Cmd-Shift-M (コメント追加) の連続技が使えて、思考が停止しないためです。

本文変更方法

おわりに

Chapter 1 くらいは終わるかと思ったのですが、インテグレーションキーの部分が画面構成など全面的な変更になってしまったので、本文も含めてかなり大幅な変更になってしまいました。この後は今回ほど大きな変更点は多くないので、もう少し進められると思っています。

hkob.notion.site