はじめに
Notion APIの正式リリースからもうすぐで二年を迎えます。
リリースされてから様々な機能が追加されましたが、今回はNotion APIを利用してYouTubeやVimeoの動画を埋め込む方法を紹介します。
事前準備
今回は以下のステップでNotion APIの環境を構築しました。
- 「my-integrations」のページからAPIキーを発行
- APIで操作したいNotionのページの「Connections」＞「Add connections」から先程作成したインテグレーションを追加
- 操作したいページのURLからブロックIDを取得
詳細は以前執筆した以下の記事や公式のガイドをご確認ください。
Notion APIでYouTubeの動画を埋め込む
早速Notion APIでYouTubeの動画を埋め込んでみましょう。
block_id と $NOTION_API_KEY はそれぞれの環境に合わせて設定してください。
curl -X PATCH 'https://api.notion.com/v1/blocks/{block_id}/children' \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Content-Type: application/json" \
-H "Notion-Version: 2022-06-28" \
--data '{
"children": [
{
"type": "video",
"video": {
"type": "external",
"external": {
"url": "https://www.youtube.com/watch?v=CpqhPcswA1Q"
}
}
}
]
}'
ブロックのタイプは "type": "video" で指定し、 external の url でYouTubeのURLを指定します。
YouTubeのURLは以下の形式を指定することで埋め込まれることを確認しました。
https://www.youtube.com/watch?v=[id]https://www.youtube.com/embed/[id]
「2023年12月 APIテスト用」というNotionのページに対してcurlを実行すると、以下のキャプチャのようにYouTube動画が埋め込まれました。
Notion APIでVimeoの動画を埋め込む
動画の埋め込みは先ほど紹介した "type": "video" が基本ですが、Vimeoの埋め込みに関してはこの記事を執筆している2023年12月時点ではvideoブロックをサポートしていないため、以下のように別の方法で埋め込む必要があります。
curl -X PATCH 'https://api.notion.com/v1/blocks/{block_id}/children' \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Content-Type: application/json" \
-H "Notion-Version: 2022-06-28" \
--data '{
"children": [
{
"embed": {
"url": "https://player.vimeo.com/video/783455051"
}
}
]
}'
YouTube動画の場合はvideoブロックを使用しましたが、Vimeoの場合はembedでURLを指定することで動画を埋め込むことが可能です。
VimeoのURLは https://vimeo.com/〜ではなく、https://player.vimeo.com/video/〜の形式を指定しました。
curlコマンドを実行すると先程のYouTube動画の下の部分にVimeoの動画が埋め込まれました。
まとめ
今回はNotion APIを使った動画の埋め込みに関して紹介しました。
動画の埋め込みは基本的にはvideoブロックを指定し、Vimeoの場合はembedブロックを使うことで動画を埋め込むことができました。
それぞれの詳細は以下のドキュメントも参考にしてください。
告知
明日はM.Hさんによる「Stable DiffusionのSDXL1.0モデルと拡張機能のあれこれ」です。
引き続き、GMOアドマーケティング Advent Calendar 2023 をお楽しみください！