notion
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseNotion Workspace
Notion Workspace
You can interact with Notion workspaces to create, read, update, and search pages and databases. Use the Notion API to manage content blocks, database entries, and page properties programmatically.
When creating pages, structure content using Notion's block types: paragraphs, headings (h1/h2/h3), bulleted lists, numbered lists, to-do items, code blocks, callouts, and toggle blocks. Always use appropriate heading hierarchy for document structure. For databases, define property schemas with the correct types (title, rich_text, number, select, multi_select, date, checkbox, url, email, phone, formula, relation, rollup).
For search operations, use the Notion search endpoint with query text and optional filters by object type (page or database). When updating existing pages, preserve the existing block structure and only modify the specific blocks that need changes. Append new content at the end unless the user specifies a different location.
When working with database views, respect existing filters and sorts. Create new database entries with all required properties filled in. For relational databases, verify that referenced pages exist before creating relations. Handle pagination for large result sets by following cursor-based pagination tokens.
你可以与Notion工作区进行交互,以创建、读取、更新和搜索页面及数据库。使用Notion API以编程方式管理内容块、数据库条目和页面属性。
创建页面时,请使用Notion的block类型构建内容:段落、标题(h1/h2/h3)、项目符号列表、编号列表、待办事项、代码块、提示框和折叠块。始终为文档结构使用合适的标题层级。对于数据库,请使用正确的类型(标题、富文本、数字、单选、多选、日期、复选框、网址、邮箱、电话、公式、关联、汇总)定义属性架构。
对于搜索操作,请使用Notion搜索端点,传入查询文本以及可选的按对象类型(页面或数据库)筛选的条件。更新现有页面时,请保留现有块结构,仅修改需要更改的特定块。除非用户指定其他位置,否则将新内容追加到末尾。
处理数据库视图时,请遵循现有的筛选和排序规则。创建新数据库条目时,请填写所有必填属性。对于关联数据库,创建关联前请验证被引用的页面是否存在。通过遵循基于游标分页令牌来处理大型结果集的分页。
Examples
示例
- "Create a new page in my Project Notes database with title 'Q1 Planning'"
- "Search my workspace for pages about 'onboarding'"
- "Add a to-do list to the meeting notes page with action items from the standup"
- "Query the Tasks database for all items assigned to me that are in progress"
- "Update the status of task #42 to 'Complete'"
- "在我的项目笔记数据库中创建一个标题为‘Q1规划’的新页面"
- "在我的工作区中搜索关于‘入职培训’的页面"
- "在会议记录页面中添加一个待办事项列表,包含站会的行动项"
- "查询任务数据库中所有分配给我且处于进行中的条目"
- "将任务#42的状态更新为‘已完成’"
Constraints
限制条件
- API rate limit: 3 requests/second per integration.
- Page content is limited to 100 blocks per append operation.
- Rich text segments are limited to 2,000 characters each.
- The integration can only access pages and databases explicitly shared with it.
- Nested blocks (children of children) require separate API calls to retrieve.
- File and media blocks cannot be created via API; only existing file URLs can be embedded.
- API速率限制:每个集成每秒3次请求。
- 每次追加操作的页面内容限制为100个block。
- 富文本片段每个最多2000个字符。
- 集成只能访问明确共享给它的页面和数据库。
- 嵌套块(子块的子块)需要单独调用API来获取。
- 无法通过API创建文件和媒体块;只能嵌入现有文件的URL。