內部集成的完成和管理

添加完成后，您可以在"設置和成員"菜單的"我的集成"中看到新添加的內部集成。點擊集成旁邊的"…"可以獲取內部集成令牌，這個令牌用于API的自動化工作流程。

創建一個公共集成

轉換內部集成為公共集成

新創建的集成默認是內部集成。如果您需要創建公共集成，可以先創建內部集成，然后按照開發者指南的說明進行轉換。

公共集成的應用

公共集成允許開發者創建可以被更廣泛用戶使用的應用。如同API的公共測試版一樣，公共集成為開發者提供了在更大范圍內測試和使用集成的機會。

示例與實踐

開發者可以利用公共集成為Notion創建各種應用，如自動化協作工具、數據同步模塊等，進一步擴展Notion的功能和應用場景。

在Notion中設計數據表

數據表的基本設計

在Notion中，數據表的創建需在網頁端或客戶端完成。通過設計不同字段類型（如Number、Multi-select、Date等），用戶可以創建適合自己需求的數據表。

配置復雜字段和公式

例如，使用Formula字段可以根據"時間"字段自動計算星期和時間段，非常適合快速查看和分析數據。

replace(replace(replace(replace(replace(replace(replace(formatDate(prop("時間"), "d"), "6", "星期六"), "5", "星期五"), "4", "星期四"), "3", "星期三"), "2", "星期二"), "1", "星期一"), "0", "星期日") + ((formatDate(prop("時間"), "HHmm") == "0000") ? "" : (" | " + ((hour(prop("時間")) <= 7) ? "凌晨" : ((hour(prop("時間")) <= 10) ? "早上" : ((hour(prop("時間")) <= 15) ? "中午" : ((hour(prop("時間")) <= 21) ? "晚上" : "夜里"))))))

數據表的共享和協作

創建數據表后，可以通過"Share"功能邀請機器人或其他用戶訪問和編輯數據表，實現更高效的團隊協作。

創建Notion機器人

機器人概述

在Notion中，機器人（integration）是以自動化身份操作數據表的工具。每個機器人需要獨立創建，并根據需要的數據表進行訪問授權。

創建和管理機器人

在機器人管理頁面，輸入機器人名稱即可快速創建。創建后系統會生成一個密鑰，需妥善記錄以在API操作中使用。

邀請機器人訪問數據表

創建機器人后，返回數據表頁面，使用"Share"功能邀請機器人訪問數據表，以便其執行數據操作。

NotionAPI概述

API資源和操作

Notion API遵循RESTful風格，支持對數據表、頁面、塊和用戶進行操作。所有數據交互以JSON格式進行，確保了操作的簡潔性和一致性。

API接口類型

主要的API接口包括：獲取數據表信息、創建和更新頁面、列舉和創建塊、查看用戶信息，以及在權限范圍內進行搜索等。

接口使用示例

開發者可以參考API文檔中的示例，使用不同語言的HTTP請求庫進行API操作，快速集成Notion數據處理功能。

借助Python訪問NotionAPI

Python與Notion API的結合

通過Python的requests庫，開發者可以方便地與Notion API進行交互。使用示例代碼，開發者可以輕松獲取、創建和更新Notion中的數據。

import requests

r = requests.request(
    "GET",
    "https://api.notion.com/v1/pages/4a2c9f40c27e478fba4de58af0787a69",
    headers={"Authorization": "Bearer " + token, "Notion-Version": "2021-05-13"},
)
print(r.text)

獲取頁面和字段值

通過API接口，開發者可以獲取指定頁面的內容，并利用這些數據進行進一步的處理和分析。

創建新頁面示例

創建新頁面的請求體可以直接基于獲取頁面接口的響應體進行修改，從而實現自動化的數據錄入和管理。

body = {
    "parent": {"type": "database_id", "database_id": "7b093d33-7d89-40c0-8985-86be964a3fc4"},
    "properties": {
        "標簽": {"multi_select": {"name": "交通"}},
        "時間": {"date": {"start": arrow.get(time).to("+08").isoformat()}},
        "價格": {"number": 7.8},
        "來源": {"rich_text": [{"text": {"content": "支付寶"}}]},
        "內容": {"title": [{"type": "text", "text": {"content": "滴滴快車"}}]},
    },
}

通過以上步驟，開發者可以快速掌握Notion API的使用方法，將其應用于實際項目中。

FAQ

問：什么是Notion API集成？

• 答：Notion API集成是通過API接口實現Notion與其他平臺的交互。開發者可以利用這些接口來定制化地將Notion與其他應用程序結合，以滿足不同的工作流程需求。

問：如何創建一個內部Notion API集成？

• 答：要創建一個內部Notion API集成，首先需要導航到Notion的"設置和成員"中的"集成"標簽。然后，點擊"開發你自己的集成"鏈接，進入"我的集成"頁面，點擊"+新集成"按鈕，為集成命名并上傳logo。務必選擇相關的工作區來使用該集成。

問：如何將內部集成轉換為公共集成？

• 答：默認情況下，新創建的集成是內部集成。要轉換為公共集成，需要首先創建內部集成，然后按照Notion開發者指南的說明進行轉換，這樣可以讓更多用戶使用該集成。

問：Notion API可以實現哪些操作？

• 答：Notion API支持對數據表、頁面、塊和用戶的操作。主要API接口包括獲取數據表信息、創建和更新頁面、列舉和創建塊、查看用戶信息以及在權限范圍內進行搜索等操作。

問：如何使用Python與Notion API進行交互？

• 答：通過Python的requests庫，開發者可以方便地與Notion API交互。可以使用HTTP請求來獲取、創建和更新Notion中的數據。例如，通過GET請求可以獲取頁面內容，并使用POST請求創建新頁面。