共用方式為

Almanac （獨立發行者） （預覽版）

Almanac 正在構建協作基礎設施以服務於人類創造力。 使用最快的 wiki 和工作流程工具，將您的文件整合到一個美觀、有組織的單一事實來源中。

此連接器適用於以下產品和區域：

服務 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）
連絡人​​
名稱 特洛伊·泰勒
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
連接器中繼資料
Publisher 特洛伊·泰勒
網站 https://almanac.io/
隱私策略 https://almanac.io/privacy-policy
類別 通敵;內容和文件

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
工作區識別碼 字串 此 API 的工作區 ID。 對
存取權杖 （格式為「持有人 yourAccessToken」） securestring 此 API 的存取權杖 （格式為「持有人 yourAccessToken」）。 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

刪除文件屬性

從文件中移除自訂屬性。
刪除文件自訂屬性

刪除工作區層級的文件自訂屬性。
刪除活頁簿項目

從手冊中刪除項目。
匯入文件

從外部來源匯入文件。
取代文件存取權

取代文件的存取權。
取代文件資訊

更新文檔的元信息。
取代資料夾資訊

取代資料夾中繼資訊。
取得匯入

擷取現有匯入的相關資訊。
取得手冊

擷取工作區手冊清單。
取得手冊項目

擷取手冊項目清單。
取得文件

檢索工作區中所有文檔的元信息。
取得文件存取權

列出文件存取。
取得文件屬性

在工作區層級列出文件自訂屬性。
取得文件屬性

在文件層級列出文件自訂屬性。
取得文件資訊

擷取文件的中繼資訊。
取得群組

擷取使用者群組。
取得資料夾

擷取所有資料夾的清單。
取得資料夾資訊

擷取資料夾中繼資訊清單。
將使用者納入群組

擷取使用者群組的所有使用者。
建立手冊項目

將項目新增至手冊。
建立文件屬性

在工作區層級建立文件屬性。
建立資料夾

建立資料夾。
新增文件存取權

新增文件存取權。
新增文件屬性

將自訂屬性新增至文件。
更新文件存取權

更新文件的存取權。
更新文件資訊

更新文件的中繼資訊。
更新資料夾資訊

更新資料夾中繼資訊。
獲取用戶

擷取使用者清單。
移動檔案

將檔案 （文件和/或資料夾） 移至特定資料夾 （位於相同或不同的工作區中）。
移除文件存取權

從文件中移除存取權。

刪除文件屬性

作業識別碼：
DeleteDocsDocIdPropertiesId

從文件中移除自訂屬性。

參數

名稱 機碼 必要 類型 Description
文件 ID
 doc_id True integer

文件識別碼。
ID
 id True integer

識別碼。

刪除文件自訂屬性

作業識別碼：
DeletePropertiesId

刪除工作區層級的文件自訂屬性。

參數

名稱 機碼 必要 類型 Description
ID
 id True integer

識別碼。

刪除活頁簿項目

作業識別碼：
DeleteHandbooksHandbookIdItemsId

從手冊中刪除項目。

參數

名稱 機碼 必要 類型 Description
ID
 id True string

識別碼。
手冊 ID
 handbook_id True integer

手冊識別碼。

匯入文件

作業識別碼：
PostImports

從外部來源匯入文件。

參數

名稱 機碼 必要 類型 Description
檔案
 import[file] True file

要匯入的檔案。
來源
 import[source] True string

檔案的來源。

傳回

匯入模型
Import

取代文件存取權

作業識別碼：
PutDocsDocIdAccessesId

取代文件的存取權。

參數

名稱 機碼 必要 類型 Description
權限
 access[permission] True string

許可。
文件 ID
 doc_id True integer

文件識別碼。
ID
 id True integer

識別碼。

傳回

文件存取模型
DocAccess

取代文件資訊

作業識別碼：
PutDocsId

更新文檔的元信息。

參數

名稱 機碼 必要 類型 Description
Title
 doc[title] True string

文件的標題。
ID
 id True integer

識別碼。

傳回

文檔模型
Doc

取代資料夾資訊

作業識別碼：
PutFoldersId

取代資料夾中繼資訊。

參數

名稱 機碼 必要 類型 Description
資料夾標題
 folder[title] True string

資料夾標題。
ID
 id True integer

識別碼。

傳回

資料夾模型
Folder

取得匯入

作業識別碼：
GetImportsId

擷取現有匯入的相關資訊。

參數

名稱 機碼 必要 類型 Description
ID
 id True integer

識別碼。

傳回

匯入模型
Import

取得手冊

作業識別碼：
GetHandbooks

擷取工作區手冊清單。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。

傳回

response
array of Handbook

取得手冊項目

作業識別碼：
GetHandbooksHandbookIdItems

擷取手冊項目清單。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
手冊 ID
 handbook_id True integer

手冊識別碼。

傳回

response
array of HandbookItem

取得文件

作業識別碼：
GetDocs

檢索工作區中所有文檔的元信息。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
資料夾 ID
 folder_id string

選用篩選器：僅顯示位於此資料夾根目錄的檔案。

傳回

response
array of Doc

取得文件存取權

作業識別碼：
GetDocsDocIdAccesses

列出文件存取。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
文件 ID
 doc_id True integer

文件識別碼。

傳回

response
array of DocAccess

取得文件屬性

作業識別碼：
GetProperties

在工作區層級列出文件自訂屬性。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。

傳回

response
array of Property

取得文件屬性

作業識別碼：
GetDocsDocIdProperties

在文件層級列出文件自訂屬性。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
文件 ID
 doc_id True integer

文件識別碼。

傳回

response
array of DocProperty

取得文件資訊

作業識別碼：
GetDocsId

擷取文件的中繼資訊。

參數

名稱 機碼 必要 類型 Description
ID
 id True integer

識別碼。

傳回

文檔模型
Doc

取得群組

作業識別碼：
GetGroups

擷取使用者群組。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。

傳回

response
array of Group

取得資料夾

作業識別碼：
GetFolders

擷取所有資料夾的清單。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
父資料夾識別碼
 parent_folder_id string

選用篩選器：僅顯示具有此父資料夾ID的資料夾。

傳回

response
array of Folder

取得資料夾資訊

作業識別碼：
GetFoldersId

擷取資料夾中繼資訊清單。

參數

名稱 機碼 必要 類型 Description
ID
 id True string

識別碼。

傳回

資料夾模型
Folder

將使用者納入群組

作業識別碼：
GetGroupsGroupIdUsers

擷取使用者群組的所有使用者。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。
群組識別碼
 group_id True integer

群組識別碼。

傳回

response
array of User

建立手冊項目

作業識別碼：
PostHandbooksHandbookIdItems

將項目新增至手冊。

參數

名稱 機碼 必要 類型 Description
項目類型
 handbook_item[type] True string

手冊項目類型。
項目位置
 handbook_item[position] integer

如果未提供，則將項目附加為最後一個位置。
父項項目 ID
 handbook_item[parent_item_id] integer

用於巢狀目的的父項 ID。
文件 ID
 handbook_item[doc_id] True integer

僅對文檔項目需要。
項目標題
 handbook_item[title] True string

僅對部分和鏈接項目需要。
項目網址
 handbook_item[url] True string

僅連結項目需要。
手冊 ID
 handbook_id True integer

手冊識別碼。

傳回

HandbookItem 模型
HandbookItem

建立文件屬性

作業識別碼：
PostProperties

在工作區層級建立文件屬性。

參數

名稱 機碼 必要 類型 Description
屬性名稱
 property[name] True string

屬性名稱，每個工作區必須是唯一的。
物業類型
 property[type] True string

屬性類型。
文章的預設值
 property[default_for_articles] boolean

自動將此屬性添加到新條目中？ 預設值為 false。
數據格式
 property[meta][date_format] string

對於類型為日期的屬性，這是選擇性的。
號碼格式
 property[meta][number_format] string

對於類型為 number 的屬性，這是選擇性的。
允許提及多人
 property[meta][allow_mentioning_multiple_people] boolean

對於類型為 person 的屬性，這是選擇性的。
通知人員
 property[meta][notify_person] boolean

對於類型為 person 的屬性，這是選擇性的。
屬性值
 property[property_values][][value] True array

屬性值。
顏色
 property[property_values][][meta][color] array

色彩。

傳回

屬性模型
Property

建立資料夾

作業識別碼：
PostFolders

建立資料夾。

參數

名稱 機碼 必要 類型 Description
資料夾標題
 folder[title] True string

資料夾標題。
父資料夾識別碼
 folder[parent_folder_id] integer

父資料夾的 ID。 如果未提供，則會在工作區根目錄建立。

傳回

資料夾模型
Folder

新增文件存取權

作業識別碼：
PostDocsDocIdAccesses

新增文件存取權。

參數

名稱 機碼 必要 類型 Description
權限
 access[permission] True string

許可。
存取子類型
 access[accessor_type] True string

存取子類型。
存取子識別碼
 access[accessor_id] True integer

存取子識別碼。
文件 ID
 doc_id True integer

文件識別碼。

傳回

文件存取模型
DocAccess

新增文件屬性

作業識別碼：
PostDocsDocIdProperties

將自訂屬性新增至文件。

參數

名稱 機碼 必要 類型 Description
屬性 ID
 property_id True integer

屬性識別碼。
價值觀
 value string

參數類型 value 取決於屬性類型： 'text'， 'date'， 'number'， 'link' => String 'single_select' => { 'selected_item_id'： Integer }， the PropertyValue#ID 'multi_select' => { 'selected_item_ids'： Array[Integer] }， 選取的 PropertyValue#IDs 'checkbox' => { 'checked'： Boolean } 'document' => { 'doc_id'： Integer }， the Document#ID 'person' => { 'user_ids'： Array[Integer] }， the User#IDs.
文件 ID
 doc_id True integer

文件識別碼。

傳回

文檔屬性模型
DocProperty

更新文件存取權

作業識別碼：
PatchDocsDocIdAccessesId

更新文件的存取權。

參數

名稱 機碼 必要 類型 Description
權限
 access[permission] True string

許可。
文件 ID
 doc_id True integer

文件識別碼。
ID
 id True integer

識別碼。

傳回

文件存取模型
DocAccess

更新文件資訊

作業識別碼：
PatchDocsId

更新文件的中繼資訊。

參數

名稱 機碼 必要 類型 Description
Title
 doc[title] True string

文件的標題。
ID
 id True integer

識別碼。

傳回

文檔模型
Doc

更新資料夾資訊

作業識別碼：
PatchFoldersId

更新資料夾中繼資訊。

參數

名稱 機碼 必要 類型 Description
資料夾標題
 folder[title] True string

資料夾標題。
ID
 id True integer

識別碼。

傳回

資料夾模型
Folder

獲取用戶

作業識別碼：
GetUsers

擷取使用者清單。

參數

名稱 機碼 必要 類型 Description
頁面
 page integer

要擷取的頁面偏移。
物品
 items integer

每頁要退回的項目數。

傳回

response
array of User

移動檔案

作業識別碼：
PostFilesMove

將檔案 （文件和/或資料夾） 移至特定資料夾 （位於相同或不同的工作區中）。

參數

名稱 機碼 必要 類型 Description
資料夾 ID
 folder_ids[] array

資料夾識別碼。
文件 ID
 doc_ids[] array

文件識別碼。
目的地資料夾識別碼
 destination_folder_id integer

目的地資料夾識別碼。
目的地工作區ID
 destination_workspace_id integer

目的地工作區識別碼。

移除文件存取權

作業識別碼：
DeleteDocsDocIdAccessesId

從文件中移除存取權。

參數

名稱 機碼 必要 類型 Description
文件 ID
 doc_id True integer

文件識別碼。
ID
 id True integer

識別碼。

定義

User

名稱 路徑 類型 Description
ID
 id integer

識別碼
名字
 first_name string

第一個名字。
姓氏
 last_name string

姓氏。

群體

名稱 路徑 類型 Description
ID
 id integer

識別碼
名稱
 name string

名稱。
Description
 description string

描述。
可及性
 accessibility string

可訪問性。

房產

名稱 路徑 類型 Description
ID
 id integer

識別碼
名稱
 name string

名稱。
類型
 type string

型別。
文章的預設值
 default_for_articles boolean

是否預設文章。
元數據
 meta PropertyMeta
property_values
 property_values array of PropertyValue

屬性元

名稱 路徑 類型 Description
號碼格式
 number_format string

僅傳回 & 與類型為 number 的屬性相關。
日期格式
 date_format string

僅傳回且與類型為日期的屬性相關
允許提及多人
 allow_mentioning_multiple_people boolean

僅傳回 且 relevant 適用於類型為 person 的屬性。
通知人員
 notify_person boolean

僅傳回 且 relevant 適用於類型為 person 的屬性。

PropertyValue

名稱 路徑 類型 Description
ID
 id integer

識別碼
屬性 ID
 property_id integer

屬性識別碼。
價值觀
 value string

值。
元數據
 meta PropertyValueMeta

屬性值元（PropertyValueMeta）

名稱 路徑 類型 Description
顏色
 color string

僅針對類型為 single_select 和 multi_select 的屬性傳回 & 相關。

手冊項目

名稱 路徑 類型 Description
ID
 id integer

識別碼
手冊 ID
 handbook_id integer

手冊識別碼。
類型
 type string

型別。
Position
 position integer

職位。
Title
 title string

僅與部分和鏈接項目相關。
URL
 url string

僅與連結項目相關。
父項項目 ID
 parent_item_id integer

如果專案是巢狀的，則為非 Null。
文件 ID
 doc_id integer

僅與文檔項目相關。

手冊

名稱 路徑 類型 Description
ID
 id integer

識別碼
名稱
 name string

名稱。

資料夾

名稱 路徑 類型 Description
ID
 id integer

識別碼
Title
 title string

標題。
工作區識別碼
 workspace_id integer

工作區標識碼。
父資料夾識別碼
 parent_folder_id integer

父資料夾識別碼。

DocAccess

名稱 路徑 類型 Description
ID
 id integer

識別碼
文件 ID
 doc_id integer

文件識別碼。
權限
 permission string

許可。
存取子類型
 accessor_type string

存取子類型。
存取子識別碼
 accessor_id integer

存取子識別碼。
已繼承
 inherited boolean

是否遺傳。

文件屬性

名稱 路徑 類型 Description
ID
 id integer

識別碼
屬性模型
 property Property
價值觀
 value string

類型 value 取決於屬性類型： 'text'， 'date'， 'number'， 'link' => String 'single_select' => { 'selected_item_id'： Integer }， the PropertyValue#ID 'multi_select' => { 'selected_item_ids'： Array[Integer] }， 選取的 PropertyValue#IDs 'checkbox' => { 'checked'： Boolean } 'document' => { 'doc_id'： Integer }， the Document#ID 'person' => { 'user_ids'： Array[Integer] }， the User#IDs.

醫生

名稱 路徑 類型 Description
ID
 id integer

識別碼
Title
 title string

標題。
工作區識別碼
 workspace_id integer

工作區標識碼。
資料夾 ID
 folder_id integer

資料夾識別碼。
負責人識別碼
 owner_id integer

文件擁有者的使用者 ID。
創建於
 created_at string

ISO8601格式化的日期時間。
更新於
 updated_at string

ISO8601格式化的日期時間。

Import

名稱 路徑 類型 Description
ID
 id integer

識別碼
狀態
 status string
文檔模型
 doc Doc