13.1 bot ユーザの取得 (Retrieve your token’s bot user)

• Bot ユーザを取得するスクリプトを dry_run で確認します。

• 後で参照するために結果を記録しておきます。
📝
JSON 部分をコピー&貼り付け

• bot user 取得の API の説明はこちらです。
Start building with the Notion API
Retrieves the bot User associated with the API token provided in the authorization header. The bot will have an owner field with information about the person who authorized the integration. Integration capabilities This endpoint is accessible from by integrations with any level of capabilities.

https://developers.notion.com/reference/get-self

• Talend API Tester には以下のようにパラメータを設定します。

• 全てを設定すると以下のようになります。Bearer の後ろのスペースを忘れないでください。最後に Send を押すと結果が返ってきます。

13.2 ユーザの取得 (Retrieve a user)

• ユーザ取得 API の説明はこちらです。
Start building with the Notion API
Retrieves a User using the ID specified. Integration capabilities This endpoint requires an integration to have user information capabilities. Attempting to call this API without user information capabilities will return an HTTP response with a 403 status code. For more information on integration capabilities, see the capabilities guide.

https://developers.notion.com/reference/get-user

• 2章で取得したユーザ ID がここに表示されています。
📝
自分の User Object の id を記録します。"id": "この部分をコピー"のような形式の部分があるので、該当部分をコピーして、以下の欄に貼り付けておいてください。
例: 2200a911-6a96-44bb-bd38-6bfb1e01b9f6

• この user_id を SCHEME の me の部分に置き換えて、Send します。

13.3 ページの取得 (Retrieve a page)

• ページ取得 API の説明はこちらです。
Start building with the Notion API
Retrieves a Page object using the ID specified. Responses contains page properties, not page content. To fetch page content, use the retrieve block children endpoint. Each page property item is computed with a limit of 25 page references.

https://developers.notion.com/reference/retrieve-a-page

• このページの URL を取得してここに貼り付けてください。
📝
ページURL
例: https://www.notion.so/hkob/S13-Read-2bcd8e4e98ab81cea74ef106c385b9ed?source=copy_link

• この URL からこのページ ID を取り出して貼り付けておきましょう。
📝
page_id (上記ページ URL の末尾または ? の前の 32 桁の 16 進数)
例: 2bcd8e4e98ab81cea74ef106c385b9ed

13.4 データベースの取得 (Retrieve a database)

• データベース取得 API の説明はこちらです。
Start building with the Notion API
Retrieves a Database object using the ID specified. Integration capabilities This endpoint is accessible from by integrations with any level of capabilities. The database object returned will adhere to the limitations of the integration's capabilities. For more information on integration capabilities, see the capabilities guide.

https://developers.notion.com/reference/retrieve-a-database

• 2章のサンプルデータベースをメンションしています。データベースのリンクを取得するには、リンク先を開いてから、Cmd-L や Ctrl-L で URL を取得してください。
サンプルデータベース

• 取得したデータベース URL を貼り付けておきましょう。
📝
データベースURL
例: https://www.notion.so/hkob/2bcd8e4e98ab813a8b68cfec895adc46?v=2bcd8e4e98ab81a1ae41000c30da63b2&source=copy_link

• この URL からこのデータベースの ID を取り出して貼り付けておきましょう。
📝
database_id 上の URL の / から ? までの間の 32 桁の 16 進数)
例: 2bcd8e4e98ab813a8b68cfec895adc46

• ヘッダ部分は Page object の場合から変更がないので、SCHEME の部分だけ修正すればよいです。

• 表示された結果からこのデータベースコンテナに含まれるデータソースの ID を取り出して貼り付けておきましょう。
📝
data_sources キーオブジェクトの中の id を転記してください。
例: 2bcd8e4e-98ab-8127-a7e7-000b1ca841bd

13.5 データソースの取得 (Retrieve a data source)

• データソース取得 API の説明はこちらです。
Retrieve a data source
Retrieves a data source object — information that describes the structure and columns of a data source — for a provided data source ID. The response adheres to any limits to an integration’s capabilities and the permissions of the parent database. To fetch data source rows (i.e. the child pages of a...

https://developers.notion.com/reference/retrieve-a-data-source

• ヘッダ部分は Database object の場合から変更がないので、SCHEME の部分だけ修正すればよいです。- は入ったままでも大丈夫です。

13.6 ブロックの取得 (Retrieve a block)

• ブロック取得 API の説明はこちらです。
Start building with the Notion API
Retrieves a Block object using the ID specified. If a block contains the key has_children: true, use the Retrieve block children endpoint to get the list of children Integration capabilities This endpoint requires an integration to have read content capabilities. Attempting to call this API without read content capabilities will return an HTTP response with a 403 status code.

https://developers.notion.com/reference/retrieve-a-block

• 取得したブロック URL を貼り付けておきましょう。
📝
ブロックURL
例: https://www.notion.so/hkob/S13-Read-2bcd8e4e98ab81cea74ef106c385b9ed?source=copy_link#2bcd8e4e98ab8174b977e274471313c2

13.6 プロパティの取得 (Retrieve a page property item)