如何在 Notion API 中获取块 ID？

Posted 2023-02-16

【中文标题】如何在 Notion API 中获取块 ID？

【英文标题】：How to get the block Id in Notion API?

【发布时间】：2021-08-09 14:14:58

【问题描述】：

当我尝试附加子块时，块 ID 是必需的。 我试图在文档中找到但没有得到它。 我怎样才能得到那个块 id？

【参考方案1】：

official documentation 说：

块对象表示 Notion 中的内容。块可以是文本、列表、媒体等。页面也是一种块！

某些块中嵌套了更多内容。一些示例是缩进的段落、列表和切换。嵌套的内容称为子项，子项也是块！支持子元素的块类型有“paragraph”、“bulleted_list_item”、“numbered_list_item”、“toggle”、“to_do”和“page”。

要获取页面的 id，只需在 notion 中打开页面并检查 URL。页面的 URL 通常具有以下格式：

https://www.notion.so/Creating-Page-Sample-ee18b8779ae54f358b09221d6665ee15

ee18b8779ae54f358b09221d6665ee15是页面的id，可以作为block id。

要获取其他类型块的 id（段落”、“bulleted_list_item”、“numbered_list_item”、“toggle”、“to_do”），只需单击该块的菜单图标，然后单击“复制链接”。

然后，将链接粘贴到浏览器中，它应该如下所示：

https://www.notion.so/Creating-Page-Sample-ee18b8779ae54f358b09221d6665ee15#7fcb3940a1264aadb2ad4ee9ffe11b0e

7fcb3940a1264aadb2ad4ee9ffe11b0e 是您可以在请求中使用的块 ID。

【讨论】：

非常感谢您的帮助！我被那些连字符弄糊涂了。

为什么官方文档中没有提到这个？ ?

【参考方案2】：

official documentation 中有一个例子，他们说

block_id 参数是任何现有块的 ID。如果您按照上面的示例进行操作，则响应包含页面 ID。让我们使用该页面 ID 从页面中读取示例内容。我们将使用“16d8004e-5f6a-42a6-9811-51c22ddada12”作为块 ID。

因此，我会将 PageID 用作 Append Block Children 方法的 BlockID。

【讨论】：

我首先被 API 搞糊涂了。我最初的想法是-我检索页面->获取块ID->使用这些ID来获取内容。但这似乎要容易得多。我刚刚检索了块子项，您提到的块只是一个页面ID。