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

はじめに

hkob の雑記録の第341回目は、Section-009 の File object, Emoji object, Parent objectの修正と File upload object の追記を行なっていきます。本記事は2025年ユカスタマスの7日目(2023年ユカスタマスの738日目)の記事になります。

P.37 File object

前回の User object も共通オブジェクトに含めたので、昨日の User object の冒頭の文章は少し修正しました。また、テンプレートのブロックURLの形が変更になっていました。以前は

https://www.notion.so/hkob/2-620dec0c29ca44e29b5a6f35eff516a2#38af0e9ad8e945abba63232ba5b23796

のような形式でしたが、最近は URL に ?source=copy_link が追加されています。 block_id については、以前と同様に URL の末尾の # の後ろに存在しています。

https://www.notion.so/hkob/S9-2bcd8e4e98ab81e4901dd8718a434cca?source=copy_link#2bcd8e4e98ab81a88a99dd4b8029ef11

また、当時はファイルをアップロードする仕組みがなかったので、「ただし、現在 API でファイルをアップロードする仕組みが用意されていないため、値を変更できるのは "external" のみとなります。」という文章がありましたが、この部分は削除しました。その代わり段落の最後に「一方、 "internal" キーオブジェクトには Notion にアップロードされたファイルを一時的にアクセスできる URL を示す "url" キーと、そのリンクの有効期限である "expiry_time" が含まれています。ただし、このオブジェクトは読み込みのみの対応になります。ファイルのアップロードについては、後述する File upload object を利用します。」という文章を追加しました。

P.37 に File upload object を追記

File upload object については、新規の共通オブジェクトなので副節を追加します。ただし、既存のブロックには存在しないブロックなので、以下の文章のみを追加するだけとします。「File upload object はファイルアップロードの時だけに一時的に作成し、既存のブロックに接続することができる共通オブジェクトです。このため、既存にページには存在しないので、ここでは存在の紹介のみとし、15節のブロックの更新の際に詳細に解説します。」

P.38 Emoji object

Emoji object についても、テンプレートのブロック URL と、返却される block の ID のみの変更だけでした。

P.39 Parent object

Parent object についても、返却される block の ID のみの変更だけでした。

おわりに

今日も短いのですが、次の Rich text object はかなり長いので、ここで切っておきます。

hkob.notion.site