公式のNotion APIをPythonで叩く（Notion SDK for Python）
schedule 2023-06-27
Table of Contents
PythonでNotion API(Public Beta)を叩いてみます。
概要
2021年5月にNotionのAPIが公開されました。これ以前はnotin-pyなど非公式のAPIを使う他ありませんでした。Public Betaの段階ですが、公式APIを使ってNotionを操作するための日本語の情報が少ないため、簡単に記述していきます。詳細の確認は英語ですが公式ドキュメントがとても役立ちます。
現時点でNotionは日本語対応していないため、Notionの言語は英語の状態で手順を記載します。
準備
Installation
pipなどでnotion-clientを導入します。
pip install notion-client
Integrations
https://www.notion.so/my-integrationsからIntegrationを作成します。notion-clientで作成したIntegrationを使い、Notion APIを叩きます。
手順
- ページにアクセスする
- ［New integration］をクリックする
- フォームに値を入力する
- Integration名を入力する（e.g. myIntg）
- アイコンを設定する（任意）
- APIで操作するWorkspacesを選択する
- ［Submit］をクリックする
一連の操作を終えると、Tokenが発行されます。［Secret］のInternal Integration Tokenのテキストボックスをクリックすると、Tokenを表示できます。もう一度、クリックしてTokenをCopyしてください。
コピーしたTokenは環境変数NOTION_TOKENにセットするか、メモ帳などに貼り付けるかしてください。
Integration Invitations（重要）
Integrationを作成しましたが、作成したままの状態だとAPIを十分に使用できません。Workspacesにアクセスして、以下の手順で操作の準備をします。
- APIで操作したいページを選択する
- 画面上部のバーからShareをクリックする
- ［Invite］をクリックする
- 作成したIntegrationをクリックする
- ［Invite］をクリックする
操作のあと、Shareの一覧に作成したIntegrationが表示されたら、そのページをAPI経由で操作できるようになります。
PythonでAPIの認証をする
PythonでAPIを操作する準備をします。以下のコードで認証します。
import os
from notion_client import Client
token: str = os.environ.get(“NOTION_TOKEN”, “yourToken”)
notion = Client(auth=token)
公式ドキュメントに従って、環境変数を使ってtokenの入力をします。環境変数がよくわからなかったり、os.environの箇所でエラーが出てしまう場合には、“yourToken”をメモ帳などに貼り付けたTokenに書き換えて再実行してください（この時、GitHubなどにTokenをシェアしてしまわないようご注意ください）。
ErrorのResponseがなければ、一旦APIの認証が完了となります。
ユーザー情報を取得する(UserEndpoint)
準備の最終段階として、UsersEndpointをつかってユーザー情報の取得をします。
>>> from pprint import pprint
>>>
>>> list_users_response = notion.users.list()
>>> pprint(list_users_response)
{‘has_more’: False,
‘next_cursor’: None,
‘object’: ‘list’,
‘results’: [{‘avatar_url’: ‘https://lh3.googleusercontent.com/a-/HOGEHOGE’,
‘id’: ‘323343xx-xxxx-xxxx-xxxx-xxxxxxxxxxxx’,
‘name’: ‘yourName’,
‘object’: ‘user’,
‘person’: {‘email’: ‘yourAddress@gmail.com’},
‘type’: ‘person’},
{‘avatar_url’: None,
‘bot’: {},
‘id’: ‘323343xx-yyyy-yyyy-yyyy-xxxxxxxxxxxx,
‘name’: ‘myIntg’,
‘object’: ‘user’,
‘type’: ‘bot’},
]}
ID
NotionのAPIを使うときに、IDで操作の対象を指定します。URLからある程度IDを確認できます。Page IDより下位にあるIDはAPIを叩いたり、ChromeのDeveloperツールなどから確認したりなどが必要となります。
https://www.notion.so/1349f9e927674a03a87d772483dd5b1b?v=05282e02290749fd95decb0df0dc3f5c&p=de3635356a224c569f103a2038dc3521
|--------- Database ID ---------| |--------- Page ID ------------|
APIをつかう
SearchEndpoint
SearchEndpointでは、ページやデータベースの検索ができます。Query引数に検索した文字を入力すると、一致したページやデータベースを返してくれます。
>>> from pprint import pprint
>>>
>>> ret = notion.search(query=“My”, )
>>> pprint(ret)
{‘has_more’: False,
‘next_cursor’: None,
‘object’: ‘list’,
‘results’: [{‘archived’: False,
‘created_time’: ‘2021-06-26T05:29:00.000Z’,
‘id’: ‘65431967-c345-4c73-94eb-089c7781874f’,
‘last_edited_time’: ‘2021-06-27T02:37:36.229Z’,
‘object’: ‘page’,
‘parent’: {‘type’: ‘workspace’, ‘workspace’: True},
‘properties’: {‘title’: {‘id’: ‘title’,
‘title’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘MyTask’,
‘text’: {‘content’: ‘MyTask’,
‘link’: None},
‘type’: ‘text’}],
‘type’: ‘title’}}}]}
DatabasesEndpoint
DatabasesEndpointでデータベース周りの操作ができます。
list
データベースの一覧とデータベースの定義を取得できます。データベースの定義は、API（Query）を使って値を更新する際に役立ちます。
>>> ret = notion.databases.list()
>>> pprint(ret)
{‘has_more’: False,
‘next_cursor’: None,
‘object’: ‘list’,
‘results’: [{‘created_time’: ‘2021-06-26T04:01:53.032Z’,
‘id’: ‘1349f9e9-xxxx-xxxx-xxxx-xxxxxxxxxxxx’,
‘last_edited_time’: ‘2021-06-27T02:37:36.229Z’,
‘object’: ‘database’,
‘parent’: {‘type’: ‘workspace’, ‘workspace’: True},
‘properties’: {‘Created’: {‘created_time’: {},
‘id’: ‘s]Ff’,
‘type’: ‘created_time’},
‘Favorite’: {‘checkbox’: {},
‘id’: ‘VQ{u’,
‘type’: ‘checkbox’},
‘Name’: {‘id’: ‘title’,
‘title’: {},
‘type’: ‘title’},
‘Notion’: {‘id’: ‘taF'</span>, <span class="hljs-string">'rich_text'</span>: {}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'rich_text'</span>}, <span class="hljs-string">'Tags'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'{OB\\'</span>, <span class="hljs-string">'multi_select'</span>: {<span class="hljs-string">'options'</span>: [{<span class="hljs-string">'color'</span>: <span class="hljs-string">'pink'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'fd33a0a5-yyyy-yyyy-yyyy-yyyyyyyyyyyy'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Notion'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'red'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'035c85d1-zzzz-zzzz-zzzz-zzzzzzzzzzzz'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Python'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'green'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'b8f93b98-aaaa-aaaa-aaaa-aaaaaaaaaaaa'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'DLL'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'green'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'38341073-bbbb-bbbb-bbbb-bbbbbbbbbbbb'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'GoLang'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'brown'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'b77ec500-cccc-cccc-cccc-cccccccccc'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'API'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'blue'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'f0613703-dddd-dddd-dddd-dddddddddddd'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Swift'</span>}]}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'multi_select'</span>}, <span class="hljs-string">'URL'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'b;Si'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'url'</span>, <span class="hljs-string">'url'</span>: {}}}, <span class="hljs-string">'title'</span>: [{<span class="hljs-string">'annotations'</span>: {<span class="hljs-string">'bold'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'code'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'color'</span>: <span class="hljs-string">'default'</span>, <span class="hljs-string">'italic'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'strikethrough'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'underline'</span>: <span class="hljs-literal">False</span>}, <span class="hljs-string">'href'</span>: <span class="hljs-literal">None</span>, <span class="hljs-string">'plain_text'</span>: <span class="hljs-string">'WebClips'</span>, <span class="hljs-string">'text'</span>: {<span class="hljs-string">'content'</span>: <span class="hljs-string">'WebClips'</span>, <span class="hljs-string">'link'</span>: <span class="hljs-literal">None</span>}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'text'</span>}]}, {<span class="hljs-string">'created_time'</span>: <span class="hljs-string">'2021-06-26T13:02:55.254Z'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'9da953b5-dddd-dddd-dddd-dddddddddddd'</span>, <span class="hljs-string">'last_edited_time'</span>: <span class="hljs-string">'2021-06-27T03:36:00.000Z'</span>, <span class="hljs-string">'object'</span>: <span class="hljs-string">'database'</span>, <span class="hljs-string">'parent'</span>: {<span class="hljs-string">'type'</span>: <span class="hljs-string">'workspace'</span>, <span class="hljs-string">'workspace'</span>: <span class="hljs-literal">True</span>}, <span class="hljs-string">'properties'</span>: {<span class="hljs-string">'Created'</span>: {<span class="hljs-string">'created_time'</span>: {}, <span class="hljs-string">'id'</span>: <span class="hljs-string">']r?p'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'created_time'</span>}, <span class="hljs-string">'Ebook'</span>: {<span class="hljs-string">'checkbox'</span>: {}, <span class="hljs-string">'id'</span>: <span class="hljs-string">'An=Z'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'checkbox'</span>}, <span class="hljs-string">'Favorite'</span>: {<span class="hljs-string">'checkbox'</span>: {}, <span class="hljs-string">'id'</span>: <span class="hljs-string">'iHkR'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'checkbox'</span>}, <span class="hljs-string">'Name'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'title'</span>, <span class="hljs-string">'title'</span>: {}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'title'</span>}, <span class="hljs-string">'Rate'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'\\Lit'</span>, <span class="hljs-string">'select'</span>: {<span class="hljs-string">'options'</span>: [{<span class="hljs-string">'color'</span>: <span class="hljs-string">'red'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'64d85ca2-eeee-eeee-eeee-eeeeeeeeeeee'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'5'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'pink'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'2ec6eb09-ffff-ffff-ffff-ffffffffffff'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'4'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'gray'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'e86ef2d6-gggg-gggg-gggg-gggggggggggg'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'3'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'purple'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'10c2e5f8-hhhh-hhhh-hhhh-hhhhhhhhhhhh'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'2'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'green'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'75aeb67c-iiii-iiii-iiii-iiiiiiiiiiii'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'1'</span>}]}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'select'</span>}, <span class="hljs-string">'Tags'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'bdzl'</span>, <span class="hljs-string">'select'</span>: {<span class="hljs-string">'options'</span>: [{<span class="hljs-string">'color'</span>: <span class="hljs-string">'blue'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'3d2d9f81-jjjj-jjjj-jjjj-jjjjjjjjjjjj'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Bought'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'orange'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'98f3d800-gggg-gggg-gggg-gggggggggg'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Read'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'red'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'cdbbc5aa-kkkk-kkkk-kkkk-kkkkkkkkkkkk'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Reviewd'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'pink'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'b534b43e-llll-llll-llllllllllll'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Reading'</span>}, {<span class="hljs-string">'color'</span>: <span class="hljs-string">'yellow'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'12863085-mmmm-mmmm-mmmm-mmmmmmmmmmmm'</span>, <span class="hljs-string">'name'</span>: <span class="hljs-string">'Pending'</span>}]}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'select'</span>}, <span class="hljs-string">'URL'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'DFAE'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'url'</span>, <span class="hljs-string">'url'</span>: {}}}, <span class="hljs-string">'title'</span>: [{<span class="hljs-string">'annotations'</span>: {<span class="hljs-string">'bold'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'code'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'color'</span>: <span class="hljs-string">'default'</span>, <span class="hljs-string">'italic'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'strikethrough'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'underline'</span>: <span class="hljs-literal">False</span>}, <span class="hljs-string">'href'</span>: <span class="hljs-literal">None</span>, <span class="hljs-string">'plain_text'</span>: <span class="hljs-string">'Bookshelf'</span>, <span class="hljs-string">'text'</span>: {<span class="hljs-string">'content'</span>: <span class="hljs-string">'Bookshelf'</span>, <span class="hljs-string">'link'</span>: <span class="hljs-literal">None</span>}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'text'</span>}]}]} </code></pre><h4 id="hccfefa60e5">query</h4><p>queryを使うとデータベースの行を抽出できます。<a href="https://draft.blogger.com/blog/post/edit/3231669075263956300/4117163140880046642#">filter</a>は別途ドキュメントがあり、列のTypeごとにFilter方法などが記載されています。以下は、指定のdatabase_idのTags列(multi_select型)に値<code>Swift</code>が含まれているレコードを抽出するクエリです。</p><pre><code class="language-python hljs"><span class="hljs-meta">>>> </span>ret = notion.databases.query( <span class="hljs-meta">... </span> **{ <span class="hljs-meta">... </span> <span class="hljs-string">"database_id"</span>: <span class="hljs-string">"1349f9e927674a03a87d772483dd5b1b"</span>, <span class="hljs-meta">... </span> <span class="hljs-string">"filter"</span>: { <span class="hljs-meta">... </span> <span class="hljs-string">"property"</span>: <span class="hljs-string">"Tags"</span>, <span class="hljs-meta">... </span> <span class="hljs-string">"multi_select"</span>: { <span class="hljs-meta">... </span> <span class="hljs-string">"contains"</span>: <span class="hljs-string">"Swift"</span> <span class="hljs-meta">... </span> } <span class="hljs-meta">... </span> } <span class="hljs-meta">... </span> } <span class="hljs-meta">... </span>) <span class="hljs-meta">>>> </span>pprint(ret) {<span class="hljs-string">'has_more'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'next_cursor'</span>: <span class="hljs-literal">None</span>, <span class="hljs-string">'object'</span>: <span class="hljs-string">'list'</span>, <span class="hljs-string">'results'</span>: [{<span class="hljs-string">'archived'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'created_time'</span>: <span class="hljs-string">'2021-06-26T05:33:23.002Z'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'d74a8d3e-73c0-4d04-817a-897192fbfb2e'</span>, <span class="hljs-string">'last_edited_time'</span>: <span class="hljs-string">'2021-06-26T05:33:00.000Z'</span>, <span class="hljs-string">'object'</span>: <span class="hljs-string">'page'</span>, <span class="hljs-string">'parent'</span>: {<span class="hljs-string">'database_id'</span>: <span class="hljs-string">'1349f9e9-2767-4a03-a87d-772483dd5b1b'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'database_id'</span>}, <span class="hljs-string">'properties'</span>: {<span class="hljs-string">'Created'</span>: {<span class="hljs-string">'created_time'</span>: <span class="hljs-string">'2021-06-26T05:33:23.002Z'</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'s]Ff'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'created_time'</span>}, <span class="hljs-string">'Favorite'</span>: {<span class="hljs-string">'checkbox'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'id'</span>: <span class="hljs-string">'VQ{u'</span>, <span class="hljs-string">'type'</span>: <span class="hljs-string">'checkbox'</span>}, <span class="hljs-string">'Name'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'title'</span>, <span class="hljs-string">'title'</span>: [{<span class="hljs-string">'annotations'</span>: {<span class="hljs-string">'bold'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'code'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'color'</span>: <span class="hljs-string">'default'</span>, <span class="hljs-string">'italic'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'strikethrough'</span>: <span class="hljs-literal">False</span>, <span class="hljs-string">'underline'</span>: <span class="hljs-literal">False</span>}, <span class="hljs-string">'href'</span>: <span class="hljs-literal">None</span>, <span class="hljs-string">'plain_text'</span>: <span class="hljs-string">'noppefoxwolf/notion: '</span> <span class="hljs-string">'noppefoxwolf/notion '</span> <span class="hljs-string">'is a notion.so '</span> <span class="hljs-string">'API library '</span> <span class="hljs-string">'written in '</span> <span class="hljs-string">'swift.'</span>, <span class="hljs-string">'text'</span>: {<span class="hljs-string">'content'</span>: <span class="hljs-string">'noppefoxwolf/notion: '</span> <span class="hljs-string">'noppefoxwolf/notion '</span> <span class="hljs-string">'is a '</span> <span class="hljs-string">'notion.so '</span> <span class="hljs-string">'API '</span> <span class="hljs-string">'library '</span> <span class="hljs-string">'written '</span> <span class="hljs-string">'in '</span> <span class="hljs-string">'swift.'</span>, <span class="hljs-string">'link'</span>: <span class="hljs-literal">None</span>}, <span class="hljs-string">'type'</span>: <span class="hljs-string">'text'</span>}], <span class="hljs-string">'type'</span>: <span class="hljs-string">'title'</span>}, <span class="hljs-string">'Notion'</span>: {<span class="hljs-string">'id'</span>: <span class="hljs-string">'taF’,
‘rich_text’: [],
‘type’: ‘rich_text’},
‘Tags’: {‘id’: ‘{OB\’,
‘multi_select’: [{‘color’: ‘pink’,
‘id’: ‘fd33a0a5-5c7a-469d-aafc-168106a15208’,
‘name’: ‘Notion’},
{‘color’: ‘brown’,
‘id’: ‘b77ec500-aed1-45b0-be10-06a38973273f’,
‘name’: ‘API’},
{‘color’: ‘blue’,
‘id’: ‘f0613703-e876-4dbd-8ff3-2f08f158d07e’,
‘name’: ‘Swift’}],
‘type’: ‘multi_select’},
‘URL’: {‘id’: ‘b;Si’,
‘type’: ‘url’,
‘url’: ‘https://github.com/noppefoxwolf/notion’}}}]}
Query内の辞書の前についているは辞書のアンパックです。以下と同じになります。
ret = notion.databases.query(
database_id=“1349f9e927674a03a87d772483dd5b1b”,
filter={
“property”: “Tags”,
“multi_select”: {
“contains”: “Swift”
}
}
)
retrieve
database_idに対応するデータベースの情報を取得します。IDが必要となりますが、単一のデータベースの情報を取得でき、シンプルな構造となる点で便利です。
>>> ret = notion.databases.retrieve(database_id=“1349f9e927674a03a87d772483dd5b1b”)
>>> pprint(ret)
{‘created_time’: ‘2021-06-26T04:01:53.032Z’,
‘id’: ‘1349f9e9-2767-4a03-a87d-772483dd5b1b’,
‘last_edited_time’: ‘2021-06-27T02:37:36.229Z’,
‘object’: ‘database’,
‘parent’: {‘type’: ‘workspace’, ‘workspace’: True},
‘properties’: {‘Created’: {‘created_time’: {},
‘id’: ‘s]Ff’,
‘type’: ‘created_time’},
‘Favorite’: {‘checkbox’: {}, ‘id’: ‘VQ{u’, ‘type’: ‘checkbox’},
‘Name’: {‘id’: ‘title’, ‘title’: {}, ‘type’: ‘title’},
‘Notion’: {‘id’: ‘ta`F’, ‘rich_text’: {}, ‘type’: ‘rich_text’},
‘Tags’: {‘id’: ‘{OB\’,
‘multi_select’: {‘options’: [{‘color’: ‘pink’,
‘id’: ‘fd33a0a5-5c7a-469d-aafc-168106a15208’,
‘name’: ‘Notion’},
{‘color’: ‘red’,
‘id’: ‘035c85d1-e9a0-4b40-9f7b-0f78516b084f’,
‘name’: ‘Python’},
{‘color’: ‘green’,
‘id’: ‘b8f93b98-2f81-4e4f-913a-9e355aef267c’,
‘name’: ‘DLL’},
{‘color’: ‘green’,
‘id’: ‘38341073-3d35-46f3-84bc-baeab8d3093f’,
‘name’: ‘GoLang’},
{‘color’: ‘brown’,
‘id’: ‘b77ec500-aed1-45b0-be10-06a38973273f’,
‘name’: ‘API’},
{‘color’: ‘blue’,
‘id’: ‘f0613703-e876-4dbd-8ff3-2f08f158d07e’,
‘name’: ‘Swift’}]},
‘type’: ‘multi_select’},
‘URL’: {‘id’: ‘b;Si’, ‘type’: ‘url’, ‘url’: {}}},
‘title’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘WebClips’,
‘text’: {‘content’: ‘WebClips’, ‘link’: None},
‘type’: ‘text’}]}
PagesEndpoint
ページの操作ができます。
create
pageに値を追加できます。以下はページ内のテーブルに値を追加するコードです。propertiesの設定方法はドキュメントをご確認ください。
>>> ret = notion.pages.create(
… {
… “parent”: {“database_id”: “1349f9e927674a03a87d772483dd5b1b”},
… “properties”: {
… “Name”: {
… “title”: [
… {
… “text”: {
… “content”: “TEST”
… }
… }
… ]
… },
… “URL”: {
… “url”: “https://google.com”
… },
… “Favorite”: {
… “checkbox”: True
… },
… “Tags”: {
… “multi_select”: [
… {“name”: tag} for tag in “Python,API”.split(”,”)
… ]
… }
… }
… }
… )
>>> pprint(ret)
{‘archived’: False,
‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘de363535-6a22-4c56-9f10-3a2038dc3521’,
‘last_edited_time’: ‘2021-06-27T05:18:59.743Z’,
‘object’: ‘page’,
‘parent’: {‘database_id’: ‘1349f9e9-2767-4a03-a87d-772483dd5b1b’,
‘type’: ‘database_id’},
‘properties’: {‘Created’: {‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘s]Ff’,
‘type’: ‘created_time’},
‘Favorite’: {‘checkbox’: True,
‘id’: ‘VQ{u’,
‘type’: ‘checkbox’},
‘Name’: {‘id’: ‘title’,
‘title’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘TEST’,
‘text’: {‘content’: ‘TEST’, ‘link’: None},
‘type’: ‘text’}],
‘type’: ‘title’},
‘Tags’: {‘id’: ‘{OB\’,
‘multi_select’: [{‘color’: ‘red’,
‘id’: ‘035c85d1-e9a0-4b40-9f7b-0f78516b084f’,
‘name’: ‘Python’},
{‘color’: ‘brown’,
‘id’: ‘b77ec500-aed1-45b0-be10-06a38973273f’,
‘name’: ‘API’}],
‘type’: ‘multi_select’},
‘URL’: {‘id’: ‘b;Si’,
‘type’: ‘url’,
‘url’: ‘https://google.com’}}}
retrieve
page_idに対応する対象の情報を取得します。
>>> ret = notion.pages.retrieve(page_id=“de3635356a224c569f103a2038dc3521”)
>>> pprint(ret)
{‘archived’: False,
‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘de363535-6a22-4c56-9f10-3a2038dc3521’,
‘last_edited_time’: ‘2021-06-27T05:20:00.000Z’,
‘object’: ‘page’,
‘parent’: {‘database_id’: ‘1349f9e9-2767-4a03-a87d-772483dd5b1b’,
‘type’: ‘database_id’},
‘properties’: {‘Created’: {‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘s]Ff’,
‘type’: ‘created_time’},
‘Favorite’: {‘checkbox’: True,
‘id’: ‘VQ{u’,
‘type’: ‘checkbox’},
‘Name’: {‘id’: ‘title’,
‘title’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘TEST’,
‘text’: {‘content’: ‘TEST’, ‘link’: None},
‘type’: ‘text’}],
‘type’: ‘title’},
‘Tags’: {‘id’: ‘{OB\’,
‘multi_select’: [{‘color’: ‘red’,
‘id’: ‘035c85d1-e9a0-4b40-9f7b-0f78516b084f’,
‘name’: ‘Python’},
{‘color’: ‘brown’,
‘id’: ‘b77ec500-aed1-45b0-be10-06a38973273f’,
‘name’: ‘API’}],
‘type’: ‘multi_select’},
‘URL’: {‘id’: ‘b;Si’,
‘type’: ‘url’,
‘url’: ‘https://google.com’}}}
update
page_idに対応するpropatiesの値を更新します。
>>> ret = notion.pages.update(
… **{
… “page_id”: “de3635356a224c569f103a2038dc3521”,
… “properties”: {
… “Name”: {
… “title”: [
… {
… “text”: {
… “content”: “UPDATE_TEST”
… }
… }
… ]
… }
… }
… }
… )
>>> pprint(ret)
{‘archived’: False,
‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘de363535-6a22-4c56-9f10-3a2038dc3521’,
‘last_edited_time’: ‘2021-06-27T05:36:47.559Z’,
‘object’: ‘page’,
‘parent’: {‘database_id’: ‘1349f9e9-2767-4a03-a87d-772483dd5b1b’,
‘type’: ‘database_id’},
‘properties’: {‘Created’: {‘created_time’: ‘2021-06-27T05:18:59.743Z’,
‘id’: ‘s]Ff’,
‘type’: ‘created_time’},
‘Favorite’: {‘checkbox’: True,
‘id’: ‘VQ{u’,
‘type’: ‘checkbox’},
‘Name’: {‘id’: ‘title’,
‘title’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘UPDATE_TEST’,
‘text’: {‘content’: ‘UPDATE_TEST’,
‘link’: None},
‘type’: ‘text’}],
‘type’: ‘title’},
‘Tags’: {‘id’: ‘{OB\’,
‘multi_select’: [{‘color’: ‘red’,
‘id’: ‘035c85d1-e9a0-4b40-9f7b-0f78516b084f’,
‘name’: ‘Python’},
{‘color’: ‘brown’,
‘id’: ‘b77ec500-aed1-45b0-be10-06a38973273f’,
‘name’: ‘API’}],
‘type’: ‘multi_select’},
‘URL’: {‘id’: ‘b;Si’,
‘type’: ‘url’,
‘url’: ‘https://google.com’}}}
BlocksEndpoint
ブロックの編集をします。
list
ブロックのリストを入手します。page_idもしくはblock_idを使います。page_idを使うとページ内のブロックを取得できます。
>>> page_id: str = “098ebc861d35448a9dd725184512e95d”
>>> ret = notion.blocks.children.list(block_id=page_id)
>>> pprint(ret)
{‘has_more’: False,
‘next_cursor’: None,
‘object’: ‘list’,
‘results’: [{‘created_time’: ‘2021-06-27T06:07:00.000Z’,
‘has_children’: False,
‘heading_2’: {‘text’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘Summary’,
‘text’: {‘content’: ‘Summary’,
‘link’: None},
‘type’: ‘text’}]},
‘id’: ‘a64e91a1-facb-46d9-9190-5eb96e13c217’,
‘last_edited_time’: ‘2021-06-27T06:08:00.000Z’,
‘object’: ‘block’,
‘type’: ‘heading_2’},
{‘created_time’: ‘2021-06-27T06:08:00.000Z’,
‘has_children’: False,
‘id’: ‘7428808e-a481-4b0d-9a3d-28ef6a241e4c’,
‘last_edited_time’: ‘2021-06-27T06:08:00.000Z’,
‘object’: ‘block’,
‘paragraph’: {‘text’: [{‘annotations’: {‘bold’: False,
‘code’: False,
‘color’: ‘default’,
‘italic’: False,
‘strikethrough’: False,
‘underline’: False},
‘href’: None,
‘plain_text’: ‘hogehogehugahugapiyopiyo’,
‘text’: {‘content’: ‘hogehogehugahugapiyopiyo’,
‘link’: None},
‘type’: ‘text’}]},
‘type’: ‘paragraph’},
{‘created_time’: ‘2021-06-27T06:08:00.000Z’,
‘has_children’: False,
‘id’: ‘9df4b261-8f93-4261-871e-14b9c25d4a2a’,
‘last_edited_time’: ‘2021-06-27T06:08:00.000Z’,
‘object’: ‘block’,
‘paragraph’: {‘text’: []},
‘type’: ‘paragraph’},
{‘created_time’: ‘2021-06-27T06:08:00.000Z’,
‘has_children’: False,
‘id’: ‘395347e7-ccdc-450d-ab99-a730dd68dcd7’,
‘last_edited_time’: ‘2021-06-27T06:08:00.000Z’,
‘object’: ‘block’,
‘paragraph’: {‘text’: []},
‘type’: ‘paragraph’}]}
append
指定したpage_id(block_id)にブロックを追加します。ブロックの定義方法はドキュメントに記載されています。
>>> blocks: list = [
… {
… “object”: “block”,
… “type”: “heading_2”,
… “heading_2”: {
… “text”: [
… {“type”: “text”, “text”: {“content”: “H2_TITLE”}}
… ]
… }
… },
… {
… “object”: “block”,
… “type”: “paragraph”,
… “paragraph”: {
… “text”: [
… {
… “type”: “text”,
… “text”: {
… “content”: “Hi, This is a test text.”,
… “link”: {
… “url”: “https://google.com”
… }
… }
… }
… ]
… }
… }
… ]
>>> block_id: str = “098ebc861d35448a9dd725184512e95d”
>>> ret = notion.blocks.children.append(block_id=block_id, children=blocks)
>>> pprint(ret)
{‘child_page’: {‘title’: ‘HOGEHOGE’},
‘created_time’: ‘2021-06-27T06:07:00.000Z’,
‘has_children’: True,
‘id’: ‘098ebc86-1d35-448a-9dd7-25184512e95d’,
‘last_edited_time’: ‘2021-06-27T06:12:02.595Z’,
‘object’: ‘block’,
‘type’: ‘child_page’}
Notion SDK for Pythonを使ってみて
Documentと見比べつつライブラリを使いました。Public Beta時点で使える機能を抑えており、問題なく使えそうに見えます。公式ドキュメントで詳細の確認が必要ですが、多量のデータのimportや入力の自働化など便利に使えそうです。
その他
Upload
FAQに記載されていましたがファイルのアップロードに対応していないようです。現時点で思いつく方法としては、Selenium+AHKで1つずつ上げていくぐらいでしょうか。DropboxAPIのようにBulkでのアップロードの対応に期待します。
他の言語
色々対応していそうです。その中でも、GASでGoogleのアプリと連携させたり、タイムトリガーでNotionAPIを叩くような使い方もできそうで、ちょっと興味があります。多分、記事にしないだろうと思いますが、便利な使い方とかシェアできたらそれはそれで良さそうです。