Notion 作为一款功能强大的笔记、任务管理和知识库工具，凭借其简洁的写作体验、灵活的数据库功能以及跨平台支持，赢得了众多用户的喜爱。除了丰富的预制模板和集成市场，Notion 还允许用户创建自定义集成，以满足更加个性化的需求。本文将带你深入了解 Notion 集成的世界，并使用 Rust 语言构建一个自定义集成，实现自动解析文本消息并更新 Notion 数据库的功能。

Notion 集成概述

Notion 集成可以分为两种主要类型：

• 预制集成: Notion 集成市场提供了大量预制集成，例如与 Slack、Calendly 等服务的连接，方便用户快速实现自动化流程。
• 自定义集成: 当预制集成无法满足需求时，用户可以创建自定义集成，以实现更灵活、更个性化的功能。自定义集成可以分为两种：
  • 公开集成: 公开集成可以通过 Notion 集成市场发布，供其他用户使用。
  • 内部集成: 内部集成仅供特定用户或团队使用，通常用于内部流程自动化或数据整合。

使用 Rust 构建自定义集成

本文将以一个简单的案例为例，介绍如何使用 Rust 构建一个自定义内部集成，实现自动解析文本消息并更新 Notion 数据库的功能。

1. 创建 Notion 集成

首先，我们需要在 Notion 中创建一个新的集成。访问 https://www.notion.so/my-integrations 页面，并按照以下步骤进行操作：

• 命名集成: 为集成取一个有意义的名称，例如 "Expense Tracker"。
• 选择工作区: 选择与集成相关的 Notion 工作区。
• 设置类型: 选择 "内部" 作为集成类型。
• 添加 Logo: 可选地添加一个 Logo 图片。

创建完成后，Notion 会生成一个集成令牌，该令牌用于访问工作区中的页面和数据库。

2. 连接页面和数据库

为了让集成能够访问特定的页面和数据库，需要在页面设置中添加集成。在目标页面或数据库的设置页面中，找到 "集成" 选项，并添加先前创建的集成。

3. 构建解析工具

在本例中，我们将使用 Rust 语言构建一个命令行工具，用于解析文本消息并更新 Notion 数据库。

use std::error::Error;

use reqwest::Client;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // 1. 获取 Notion 集成令牌
    let notion_token = std::env::var("NOTION_TOKEN")?;

    // 2. 获取要更新的数据库 ID
    let database_id = std::env::var("DATABASE_ID")?;

    // 3. 创建 HTTP 客户端
    let client = Client::new();

    // 4. 解析文本消息
    let transaction_text = "Transaction: 2023-10-27 Starbucks Coffee $5.00";
    let (date, vendor, amount) = parse_transaction(transaction_text)?;

    // 5. 构建 Notion API 请求
    let request_body = json!({
        "parent": { "database_id": database_id },
        "properties": {
            "Date": { "date": { "start": date }},
            "Vendor": { "rich_text": [{ "text": { "content": vendor }}] },
            "Amount": { "number": amount },
        }
    });

    // 6. 发送请求到 Notion API
    let response = client
        .post(format!("https://api.notion.com/v1/pages"))
        .header("Authorization", format!("Bearer {}", notion_token))
        .header("Content-Type", "application/json")
        .header("Notion-Version", "2022-02-22")
        .body(request_body.to_string())
        .send()
        .await?;

    // 7. 处理响应
    if response.status().is_success() {
        println!("Transaction added to Notion database.");
    } else {
        let response_text = response.text().await?;
        println!("Error adding transaction: {}", response_text);
    }

    Ok(())
}

fn parse_transaction(text: &str) -> Result<(String, String, f64), Box<dyn Error>> {
    // 使用正则表达式解析文本消息
    let re = regex::Regex::new(r"Transaction: (\d{4}-\d{2}-\d{2}) (.*) \$(\d+\.?\d*)")?;
    let captures = re.captures(text).ok_or("Invalid transaction format")?;

    let date = captures.get(1).unwrap().as_str().to_string();
    let vendor = captures.get(2).unwrap().as_str().to_string();
    let amount = captures.get(3).unwrap().as_str().parse::<f64>()?;

    Ok((date, vendor, amount))
}

代码解释：

1. 获取 Notion 集成令牌和数据库 ID: 从环境变量中读取集成令牌和数据库 ID。
2. 创建 HTTP 客户端: 使用 reqwest 库创建 HTTP 客户端，用于发送请求到 Notion API。
3. 解析文本消息: 使用 regex 库解析文本消息，提取日期、供应商和金额等信息。
4. 构建 Notion API 请求: 使用 serde_json 库构建 JSON 格式的请求体，包含页面属性信息。
5. 发送请求到 Notion API: 使用 reqwest 库发送 POST 请求到 Notion API，并添加必要的请求头。
6. 处理响应: 检查响应状态码，并根据结果输出信息。

4. 运行工具

将代码保存为 main.rs 文件，并使用 cargo build 命令编译代码。运行 cargo run 命令即可执行工具。

扩展功能

除了基本的解析和更新功能，还可以根据实际需求扩展工具的功能，例如：

• 多线程处理: 使用多线程或异步编程技术，提高解析和更新效率。
• 错误处理: 添加更完善的错误处理机制，例如记录错误日志或发送通知。
• 数据验证: 对解析后的数据进行验证，确保数据格式和内容的正确性。
• 用户界面: 添加图形用户界面，方便用户操作和管理。

总结

本文介绍了使用 Rust 构建自定义 Notion 集成的基本流程，并提供了一个简单的示例。通过自定义集成，用户可以更灵活地利用 Notion 的功能，实现更加个性化的应用场景。希望本文能够帮助你更好地理解 Notion 集成，并开始构建属于你自己的 Notion 集成。