本文纪录个人认为Notion API使用上不够直观的地方,有任何不够正确的部分还请见谅及留言教学相长。

前置步骤

  • 取得API key:前往 https://www.notion.so/profile/integrations ,如果没有可以建立一个integration填栏位只要注意关联工作空间,其他后来都能够修改,但是关联工作空间如果选错就要再重建一个integration了储存后会有个密钥,使用Python的notion_client会需要用到,另外可以照需求顺便设定内容、评论和使用者功能的权限。
  • 连结页面建立完integration后,去页面连结刚刚新增的API key,
  • 使用Python呼叫API建立新页面

    把刚刚API key的secret用来连结notion_client,以及想要新增在哪个页面中,也就是修改page_id为网址 www.notion.so/ 后面的那一串

    from notion_client import Client

    notion = Client(auth="your_notion_secret")

    # 建立页面的函式
    def create_notion_page(page_title):
    properties = {
    "title": [
    {
    "text": {
    "content": page_title
    }
    }
    ]
    }

    parent = {"type": "page_id", "page_id": "your_page_id"}
    new_page = notion.pages.create(parent=parent, properties={"title": properties})

    page_id = new_page[\'id\']
    print(f"成功建立页面 {page_title},Page ID: {page_id}")

    print("全部操作完成!请检查您的 Notion。")

    总结

    Notion几乎可以用API进行所有行为: 内容、评论和使用者功能,也可以连结很多应用,版上也有文章可以参考。

    参考连结

    https://ithelp.ithome.com.tw/articles/10303039https://developers.notion.com/docs/getting-started