Notion（獨立出版商）
Notion 連接器使用 API 來存取 Notion 的頁面、資料庫和使用者。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 錢德拉·塞卡爾 （Chandra Sekhar） 和哈希尼·瓦爾瑪 （Harshini Varma） |
| URL | https://github.com/sekharmalla |
| chandra.malla@msftcommunity.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 錢德拉·塞卡爾 （Chandra Sekhar） 和哈希尼·瓦爾瑪 （Harshini Varma） |
| 網站 | https://www.notion.so/ |
| 隱私策略 | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| 類別 | 生產力;通敵 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除區塊 |
使用指定的 ID 將 Block 物件 （包括頁面區塊） 設定為 archived： true。 注意：在 Notion UI 應用程式中，這會將區塊移至「垃圾箱」，在那裡仍然可以存取和恢復。 |
| 建立註解 |
在頁面或現有討論串中建立註解。 |
| 建立頁面 |
在指定的資料庫中建立新頁面。 現有頁面。 |
| 所有使用者清單 |
傳回工作區的編頁使用者清單 |
| 搜尋 |
搜尋與整合共用的所有頁面和子頁面。 結果可能包括資料庫。 |
| 擷取使用者 |
使用指定的 ID 擷取使用者。 |
| 擷取區塊 |
使用指定的 ID 擷取 Block 物件。 |
| 擷取區塊子項 |
使用指定的 ID 傳回區塊中包含的子區塊物件的分頁陣列 |
| 擷取權杖的機器人使用者 |
擷取與授權標頭中提供的 API 權杖相關聯的機器人使用者。 機器人將有一個所有者欄位，其中包含有關授權整合的人員的資訊。 |
| 擷取註解 |
從頁面或區塊擷取未解析的註解物件清單。 |
| 擷取資料庫 |
使用指定的識別碼擷取資料庫物件。 |
| 擷取頁面 |
使用指定的識別碼擷取 Page 物件。 |
| 擷取頁面屬性項目 |
擷取頁面屬性項目 |
| 更新區塊 |
根據圖塊類型更新指定block_id的內容。 根據區塊物件型別支援的欄位 |
| 查詢資料庫 |
取得資料庫中包含的頁面清單，根據請求中提供的篩選條件和排序條件進行篩選和排序。 |
| 附加區塊子項 |
建立新的子區塊並將其附加至指定的父block_id。 |
刪除區塊
使用指定的 ID 將 Block 物件 （包括頁面區塊） 設定為 archived： true。 注意：在 Notion UI 應用程式中，這會將區塊移至「垃圾箱」，在那裡仍然可以存取和恢復。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
blockId | True | string |
Notion 區塊的標識符 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
區塊的識別碼。 |
|
創建時間
|
created_time | date-time |
建立此區塊的日期和時間。 |
|
上次編輯時間
|
last_edited_time | date-time |
上次更新此區塊的日期和時間。 |
|
物體
|
created_by.object | string |
始終為「使用者」 |
|
Id
|
created_by.id | string |
此使用者的唯一識別碼。 |
|
物體
|
last_edited_by.object | string |
上次編輯的使用者 |
|
Id
|
last_edited_by.id | string |
此使用者的唯一識別碼。 |
|
有孩子
|
has_children | boolean |
區塊內是否有巢狀子區塊。 |
|
Archived
|
archived | boolean |
區塊的封存狀態。 |
|
類型
|
type | string |
包含類型特定區塊資訊的物件 |
建立註解
在頁面或現有討論串中建立註解。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面 ID
|
page_id | string |
頁面的識別碼 |
|
|
討論 ID
|
discussion_id | string |
Notion 區塊的標識符 |
|
|
Content
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
傳回
建立頁面
在指定的資料庫中建立新頁面。 現有頁面。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料庫識別碼
|
database_id | True | string |
資料庫的唯一識別碼。 |
|
Emoji
|
emoji | string |
表情符號 |
|
|
封面網址
|
url | string |
頁面封面圖片 URL。 |
|
|
屬性
|
properties | object |
資料庫在 Notion 中顯示的屬性結構描述。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
頁面的唯一識別碼。 |
|
創建時間
|
created_time | string |
建立此頁面的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
上次編輯時間
|
last_edited_time | string |
此頁面更新的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
Id
|
created_by.id | string |
此使用者的唯一識別碼。 |
|
Id
|
last_edited_by.id | string |
此使用者的唯一識別碼。 |
|
url
|
cover.url | string |
連結至外部託管的映像。 |
|
表情符號
|
icon.emoji | string |
表情符號字符。 |
|
database_id
|
parent.database_id | string |
database_id |
|
已存檔
|
archived | boolean |
頁面的封存狀態。 |
|
URL
|
url | string |
Notion 頁面的 URL。 |
所有使用者清單
傳回工作區的編頁使用者清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面大小
|
page_size | integer |
回應中所需完整清單中的項目數。 最大值：100 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
Notion 區塊的標識符 |
|
顯示名稱
|
name | string |
Notion 中顯示的使用者名稱。 |
|
頭像網址
|
avatar_url | string |
選擇的頭像圖像。 |
|
類型
|
type | string |
使用者的類型。 可能的值為 “person” 和 “bot”。 |
|
Email
|
string |
人員的電子郵件地址。 |
|
|
下一個游標
|
next_cursor | string |
傳回的游標，用來要求下一頁結果。 將此視為不透明值 |
|
還有更多
|
has_more | boolean |
當回應包含清單結尾時 |
搜尋
搜尋與整合共用的所有頁面和子頁面。 結果可能包括資料庫。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
提供時，會透過將查詢與頁面標題進行比較來限制傳回的頁面。 |
|
方向
|
direction | string |
排序方向。 可能的值包括遞增和遞減。 |
|
|
時間戳
|
timestamp | string |
要排序的時間戳記名稱。 可能的值包括last_edited_time。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
區塊的識別碼。 |
|
創建時間
|
created_time | string |
建立此頁面的日期和時間。 |
|
上次編輯時間
|
last_edited_time | string |
此頁面更新的日期和時間。 |
|
純文字
|
plain_text | string |
沒有註釋的純文字。 |
|
Tags
|
Tags | object |
tags 物件包含標籤清單。 |
|
URL
|
url | string |
物件的 URL。 |
|
下一個游標
|
next_cursor | string |
傳回的游標，用來要求下一頁結果。 將此視為不透明值 |
|
還有更多
|
has_more | boolean |
該區塊是否有更多區塊 |
擷取使用者
使用指定的 ID 擷取使用者。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
user_id | True | string |
此使用者的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
Notion 使用者的識別碼 |
|
使用者名
|
name | string |
使用者名稱 |
|
頭像網址
|
avatar_url | string |
選擇的頭像圖像 |
|
Email
|
string |
人員的電子郵件地址。 |
擷取區塊
使用指定的 ID 擷取 Block 物件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
blockId | True | string |
區塊的識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物件
|
object | string |
物件 |
|
識別碼
|
id | string |
區塊的識別碼。 |
|
創建時間
|
created_time | date-time |
建立此區塊的日期和時間。 |
|
上次編輯時間
|
last_edited_time | date-time |
上次更新此區塊的日期和時間。 |
|
物體
|
created_by.object | string |
始終為「使用者」 |
|
Id
|
created_by.id | string |
此使用者的唯一識別碼。 |
|
物體
|
last_edited_by.object | string |
上次編輯的使用者 |
|
Id
|
last_edited_by.id | string |
此使用者的唯一識別碼。 |
|
有孩子
|
has_children | boolean |
區塊內是否有巢狀子區塊。 |
|
Archived
|
archived | boolean |
區塊的封存狀態。 |
|
類型
|
type | string |
包含類型特定區塊資訊的物件 |
擷取區塊子項
使用指定的 ID 傳回區塊中包含的子區塊物件的分頁陣列
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
block_id | True | string |
區塊的識別碼 |
|
頁面大小
|
page_size | integer |
回應中所需完整清單中的項目數。 最大值：100 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
items.id | string |
區塊的識別碼。 |
|
創建時間
|
items.created_time | date-time |
建立此區塊的日期和時間。 |
|
上次編輯時間
|
items.last_edited_time | date-time |
上次更新此區塊的日期和時間。 |
|
有孩子
|
items.has_children | boolean |
區塊內是否有巢狀子區塊。 |
|
Archived
|
items.archived | boolean |
區塊的封存狀態。 |
|
類型
|
items.type | string |
區塊類型。 可能的值 |
|
純文字
|
plain_text | string |
段落區塊中的純文字plain_text |
|
下一個游標
|
next_cursor | string |
傳回的游標，用來要求下一頁結果。 將此視為不透明值 |
|
還有更多
|
has_more | boolean |
該區塊是否有更多區塊 |
擷取權杖的機器人使用者
擷取與授權標頭中提供的 API 權杖相關聯的機器人使用者。 機器人將有一個所有者欄位，其中包含有關授權整合的人員的資訊。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
此使用者的唯一識別碼。 |
|
名稱
|
name | string |
Notion 中顯示的使用者名稱。 |
|
頭像網址
|
avatar_url | string |
選擇的頭像圖像。 |
|
類型
|
type | string |
使用者的類型。 可能的值為 “person” 和 “bot”。 |
|
擁有者類型
|
bot.owner.type | string |
擁有者類型 - 「工作區」或「使用者」。 |
擷取註解
從頁面或區塊擷取未解析的註解物件清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
block_id | True | string |
Notion 區塊或頁面的識別碼 |
傳回
擷取資料庫
使用指定的識別碼擷取資料庫物件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料庫識別碼
|
database_id | True | string |
Notion 資料庫的識別碼 |
傳回
擷取頁面
使用指定的識別碼擷取 Page 物件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面 ID
|
page_id | True | string |
Notion 頁面的識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
頁面的唯一識別碼。 |
|
創建時間
|
created_time | string |
建立此頁面的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
上次編輯時間
|
last_edited_time | string |
此頁面更新的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
Id
|
created_by.id | string |
此使用者的唯一識別碼。 |
|
Id
|
last_edited_by.id | string |
此使用者的唯一識別碼。 |
|
url
|
cover.url | string |
連結至外部託管的映像。 |
|
表情符號
|
icon.emoji | string |
表情符號字符。 |
|
database_id
|
parent.database_id | string |
database_id |
|
已存檔
|
archived | boolean |
頁面的封存狀態。 |
|
URL
|
url | string |
Notion 頁面的 URL。 |
擷取頁面屬性項目
擷取頁面屬性項目
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面 ID
|
page_id | True | string |
Notion 頁面的識別碼 |
|
屬性 ID
|
property_id | True | string |
頁面屬性的識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物體
|
object | string |
始終列出。 |
|
還有更多
|
has_more | boolean |
當回應包含清單結尾時，false。 否則，是真的。 |
更新區塊
根據圖塊類型更新指定block_id的內容。 根據區塊物件型別支援的欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
blockId | True | string |
Notion 區塊的標識符 |
|
Content
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
|
|
Content
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
|
|
Content
|
content | string |
文字內容2. 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
|
|
Content
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
顏色 |
|
|
內容1
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
|
|
內容1
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
|
|
內容1
|
content | string |
文字內容。 此欄位包含文字的實際內容，可能是您最常使用的欄位。 |
|
|
已核對
|
checked | boolean |
是否檢查to_do。 |
|
|
顏色
|
color | string |
圖塊的顏色。 |
查詢資料庫
取得資料庫中包含的頁面清單，根據請求中提供的篩選條件和排序條件進行篩選和排序。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料庫識別碼
|
database_id | True | string |
Notion 資料庫的識別碼。 |
傳回
附加區塊子項
建立新的子區塊並將其附加至指定的父block_id。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區塊識別碼
|
block_id | True | string |
區塊的識別碼 |
|
物件
|
object | string |
物件 |
|
|
型別
|
type | string |
型別 |
|
|
型別
|
type | string |
型別 |
|
|
內容
|
content | string |
內容 |
|
|
型別
|
type | string |
型別 |
|
|
內容
|
content | string |
內容 |
|
|
url
|
url | string |
url |
定義
評論回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
註解的唯一識別碼。 |
|
頁面識別碼
|
parent.page_id | string |
此頁面所屬頁面的 ID。 |
|
討論標識碼
|
discussion_id | string |
與註解相關聯之討論串的唯一識別碼。 |
|
創建時間
|
created_time | string |
建立此註解的日期和時間。 |
|
上次編輯時間
|
last_edited_time | string |
此註解更新的日期和時間。 |
|
物件
|
created_by.object | string |
物件 |
|
識別碼
|
created_by.id | string |
識別碼 |
|
RTF
|
rich_text | array of object |
註解的內容，支援RTF格式、連結和提及。 |
|
型別
|
rich_text.type | string |
型別 |
|
Content
|
rich_text.text.content | string |
文字內容。 |
|
Link
|
rich_text.text.link | string |
本文中的任何內嵌連結。 |
|
純文字
|
rich_text.plain_text | string |
沒有註釋的純文字。 |
|
href
|
rich_text.href | string |
（選用）本文中提及的任何連結或內部 Notion 的 URL（如果有）。 |
資料庫回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
物體
|
results.object | string |
頁面或「資料庫」 |
|
Id
|
results.id | string |
資料庫的唯一識別碼。 |
|
創建時間
|
results.created_time | string |
建立此資料庫的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
上次編輯時間
|
results.last_edited_time | string |
更新此資料庫的日期和時間。 格式化為 ISO 8601 日期時間字串。 |
|
物體
|
results.created_by.object | string |
建立資料庫的使用者。 |
|
Id
|
results.created_by.id | string |
使用者的唯一識別碼 |
|
物體
|
results.last_edited_by.object | string |
建立資料庫的使用者。 |
|
Id
|
results.last_edited_by.id | string |
使用者的唯一識別碼 |
|
Archived
|
results.archived | boolean |
資料庫的封存狀態。 |
|
URL
|
results.url | string |
Notion 資料庫的 URL |