Almanac (独立系発行者)

  • リファレンス

Almanac は、人間の創造性に貢献するための共同インフラを構築しています。 最速の Wiki とワークフロー ツールを使用して、ドキュメントを美しく整理された単一の信頼できる情報源に統合します。

このコネクタは、次の製品および地域で利用可能です:

サービス クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
名前 Troy Taylor
[URL] https://www.hitachisolutions.com
メール ttaylor@hitachisolutions.com
Connector Metadata
発行者 Troy Taylor
Web サイト https://almanac.io/
プライバシー ポリシー https://almanac.io/privacy-policy
カテゴリー コラボレーション; コンテンツとファイル

接続の作成

コネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ プロパティ Required
Workspace ID string この例のワークスペース ID 値は API です。 True
アクセス トークン (形式は 'Bearer yourAccessToken') securestring この API 向けのアクセス トークン (形式は 'Bearer yourAccessToken')。 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

workbook 項目を削除する

ハンドブックから項目を削除します。
インポートの取得

既存のインポートに関する情報を取得します。
グループのユーザーを取得する

ユーザーグループのすべてのユーザーを取得します。
グループの取得

ユーザー グループを取得します。
ドキュメント アクセスの更新

ドキュメントへのアクセスを更新します。
ドキュメント アクセスの追加

ドキュメントへのアクセスを追加する
ドキュメント エンティティの削除

ドキュメントからのアクセスを削除します。
ドキュメント エンティティの置き換え

ドキュメントへのアクセスを置き換えます。
ドキュメント プロパティの追加

カスタム プロパティをドキュメントへ追加します。
ドキュメント プロパティを作成する

ワークスペースレベルでドキュメント プロパティを作成します。
ドキュメント プロパティを削除する

ドキュメントからカスタム プロパティを取り除きます。
ドキュメント プロパティを取得する

ワークスペースレベルでドキュメント カスタム プロパティを一覧表示します。
ドキュメント プロパティを取得する

ワークスペースレベルでドキュメント カスタム プロパティを一覧表示します。
ドキュメントのインポート

外部ソースからドキュメントをインポートします。
ドキュメントのカスタムプロパティを削除

ワークスペースレベルでドキュメント カスタム プロパティを削除します。
ドキュメントへのアクセス取得する

ドキュメントへのアクセスを一覧表示します。
ドキュメントを取得する

ワークスペース内のすべてのドキュメントのメタ情報を取得します。
ドキュメント情報の取得

ドキュメントのメタデータを取得します。
ドキュメント情報の更新

ドキュメントのメタ情報を更新します。
ドキュメント情報の置き換え

ドキュメントのメタ情報を更新します。
ハンドブックを入手する

ワークスペース ハンドブックの一覧を取得します。
ハンドブック項目を作成する

アイテムをハンドブックに追加します。
ハンドブック項目を取得する

ハンドブック項目の一覧を取得します。
ファイルを移動

ファイル (ドキュメントやフォルダー) を特定のフォルダー (同じまたは別のワークスペース内) に移動します。
フォルダを取得

すべてのフォルダーの一覧を取得します。
フォルダーを作成する

フォルダーを作成します。
フォルダー情報の取得

フォルダーのメタデータの一覧を取得します。
フォルダー情報の更新

フォルダーのメタ情報を更新します。
フォルダー情報の置き換え

フォルダーのメタ情報を置き換えます。
ユーザーを取得する

ユーザーの一覧を取得します。

workbook 項目を削除する

操作 ID:
DeleteHandbooksHandbookIdItemsId

ハンドブックから項目を削除します。

パラメーター

名前 キー 必須 型 説明
ID
 id True string

識別子。
ハンドブック ID
 handbook_id True integer

ハンドブックの識別子。

インポートの取得

操作 ID:
GetImportsId

既存のインポートに関する情報を取得します。

パラメーター

名前 キー 必須 型 説明
ID
 id True integer

識別子。

戻り値

モデルのインポート
Import

グループのユーザーを取得する

操作 ID:
GetGroupsGroupIdUsers

ユーザーグループのすべてのユーザーを取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
Group ID
 group_id True integer

グループの識別子。

戻り値

返答
array of User

グループの取得

操作 ID:
GetGroups

ユーザー グループを取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。

戻り値

返答
array of Group

ドキュメント アクセスの更新

操作 ID:
PatchDocsDocIdAccessesId

ドキュメントへのアクセスを更新します。

パラメーター

名前 キー 必須 型 説明
Permission
 access[permission] True string

アクセス許可。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。
ID
 id True integer

識別子。

戻り値

ドキュメント アクセスモデル
DocAccess

ドキュメント アクセスの追加

操作 ID:
PostDocsDocIdAccesses

ドキュメントへのアクセスを追加する

パラメーター

名前 キー 必須 型 説明
Permission
 access[permission] True string

アクセス許可
アクセサーのタイプ
 access[accessor_type] True string

アクセサーのタイプ。
アクセサー ID
 access[accessor_id] True integer

アクセサーの識別子。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。

戻り値

ドキュメント アクセスモデル
DocAccess

ドキュメント エンティティの削除

操作 ID:
DeleteDocsDocIdAccessesId

ドキュメントからのアクセスを削除します。

パラメーター

名前 キー 必須 型 説明
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。
ID
 id True integer

識別子。

ドキュメント エンティティの置き換え

操作 ID:
PutDocsDocIdAccessesId

ドキュメントへのアクセスを置き換えます。

パラメーター

名前 キー 必須 型 説明
Permission
 access[permission] True string

アクセス許可。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。
ID
 id True integer

識別子。

戻り値

ドキュメント アクセスモデル
DocAccess

ドキュメント プロパティの追加

操作 ID:
PostDocsDocIdProperties

カスタム プロパティをドキュメントへ追加します。

パラメーター

名前 キー 必須 型 説明
プロパティ ID
 property_id True integer

プロパティ識別子。
価値
 value string

value param のタイプはプロパティのタイプによって異なります: 'text', 'date'、'number'、'link' => String 'single_select' => { 'selected_item_id': Integer }、PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }、選択した PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }、Document#ID 'person' => { 'user_ids': Array[Integer] }、User#ID。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。

戻り値

ドキュメント プロパティ モデル
DocProperty

ドキュメント プロパティを作成する

操作 ID:
PostProperties

ワークスペースレベルでドキュメント プロパティを作成します。

パラメーター

名前 キー 必須 型 説明
プロパティ名
 property[name] True string

プロパティ名。ワークスペースごとに一意である必要があります。
プロパティの種類
 property[type] True string

プロパティの種類。
記事の既定
 property[default_for_articles] boolean

このプロパティを新しい記事に自動的に追加しますか? 既定値は False です。
データ形式
 property[meta][date_format] string

日付タイプのプロパティの場合はオプションです。
Number Format
 property[meta][number_format] string

番号タイプのプロパティの場合はオプションです。
複数の人物へのメンションを許可する
 property[meta][allow_mentioning_multiple_people] boolean

人タイプのプロパティの場合はオプションです。
通知する人
 property[meta][notify_person] boolean

人タイプのプロパティの場合はオプションです。
プロパティ値
 property[property_values][][value] True array

プロパティ値。
カラー
 property[property_values][][meta][color] array

色。

戻り値

モデル プロパティ
Property

ドキュメント プロパティを削除する

操作 ID:
DeleteDocsDocIdPropertiesId

ドキュメントからカスタム プロパティを取り除きます。

パラメーター

名前 キー 必須 型 説明
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。
ID
 id True integer

識別子。

ドキュメント プロパティを取得する

操作 ID:
GetProperties

ワークスペースレベルでドキュメント カスタム プロパティを一覧表示します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。

戻り値

返答
array of Property

ドキュメント プロパティを取得する

操作 ID:
GetDocsDocIdProperties

ワークスペースレベルでドキュメント カスタム プロパティを一覧表示します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。

戻り値

返答
array of DocProperty

ドキュメントのインポート

操作 ID:
PostImports

外部ソースからドキュメントをインポートします。

パラメーター

名前 キー 必須 型 説明
File
 import[file] True file

インポートするファイル。
Source
 import[source] True string

ファイルのソース。

戻り値

モデルのインポート
Import

ドキュメントのカスタムプロパティを削除

操作 ID:
DeletePropertiesId

ワークスペースレベルでドキュメント カスタム プロパティを削除します。

パラメーター

名前 キー 必須 型 説明
ID
 id True integer

識別子。

ドキュメントへのアクセス取得する

操作 ID:
GetDocsDocIdAccesses

ドキュメントへのアクセスを一覧表示します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
ドキュメント ID
 doc_id True integer

ドキュメントの識別子。

戻り値

返答
array of DocAccess

ドキュメントを取得する

操作 ID:
GetDocs

ワークスペース内のすべてのドキュメントのメタ情報を取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
フォルダー ID
 folder_id string

オプションのフィルター: このフォルダーのルートにあるドキュメントのみを表示します。

戻り値

返答
array of Doc

ドキュメント情報の取得

操作 ID:
GetDocsId

ドキュメントのメタデータを取得します。

パラメーター

名前 キー 必須 型 説明
ID
 id True integer

識別子。

戻り値

ドキュメント モデル
Doc

ドキュメント情報の更新

操作 ID:
PatchDocsId

ドキュメントのメタ情報を更新します。

パラメーター

名前 キー 必須 型 説明
肩書き
 doc[title] True string

ドキュメントのタイトル。
ID
 id True integer

識別子。

戻り値

ドキュメント モデル
Doc

ドキュメント情報の置き換え

操作 ID:
PutDocsId

ドキュメントのメタ情報を更新します。

パラメーター

名前 キー 必須 型 説明
肩書き
 doc[title] True string

ドキュメントのタイトル。
ID
 id True integer

識別子。

戻り値

ドキュメント モデル
Doc

ハンドブックを入手する

操作 ID:
GetHandbooks

ワークスペース ハンドブックの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。

戻り値

返答
array of Handbook

ハンドブック項目を作成する

操作 ID:
PostHandbooksHandbookIdItems

アイテムをハンドブックに追加します。

パラメーター

名前 キー 必須 型 説明
品目の種類
 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

セクション項目とリンク項目にのみ必要です。
品目 URL
 handbook_item[url] True string

リンク項目にのみ必要です。
ハンドブック ID
 handbook_id True integer

ハンドブックの識別子。

戻り値

HandbookItem モデル
HandbookItem

ハンドブック項目を取得する

操作 ID:
GetHandbooksHandbookIdItems

ハンドブック項目の一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
ハンドブック ID
 handbook_id True integer

ハンドブックの識別子。

戻り値

返答
array of HandbookItem

ファイルを移動

操作 ID:
PostFilesMove

ファイル (ドキュメントやフォルダー) を特定のフォルダー (同じまたは別のワークスペース内) に移動します。

パラメーター

名前 キー 必須 型 説明
フォルダー ID
 folder_ids[] array

フォルダーの識別子。
ドキュメント ID
 doc_ids[] array

ドキュメントの識別子。
宛先フォルダー ID
 destination_folder_id integer

宛先フォルダーへのパス
宛先のワークスペース ID
 destination_workspace_id integer

宛先ワークスペース識別子。

フォルダを取得

操作 ID:
GetFolders

すべてのフォルダーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。
親フォルダー ID
 parent_folder_id string

オプションのフィルター: この親フォルダー ID を持つフォルダーのみを表示します。

戻り値

返答
array of Folder

フォルダーを作成する

操作 ID:
PostFolders

フォルダーを作成します。

パラメーター

名前 キー 必須 型 説明
フォルダー タイトル
 folder[title] True string

フォルダー タイトル。
親フォルダー ID
 folder[parent_folder_id] integer

親フォルダーの ID。 指定しない場合は、ワークスペースのルートに作成されます。

戻り値

フォルダーモデル
Folder

フォルダー情報の取得

操作 ID:
GetFoldersId

フォルダーのメタデータの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ID
 id True string

識別子。

戻り値

フォルダーモデル
Folder

フォルダー情報の更新

操作 ID:
PatchFoldersId

フォルダーのメタ情報を更新します。

パラメーター

名前 キー 必須 型 説明
フォルダー タイトル
 folder[title] True string

フォルダー タイトル。
ID
 id True integer

識別子。

戻り値

フォルダーモデル
Folder

フォルダー情報の置き換え

操作 ID:
PutFoldersId

フォルダーのメタ情報を置き換えます。

パラメーター

名前 キー 必須 型 説明
フォルダー タイトル
 folder[title] True string

フォルダー タイトル。
ID
 id True integer

識別子。

戻り値

フォルダーモデル
Folder

ユーザーを取得する

操作 ID:
GetUsers

ユーザーの一覧を取得します。

パラメーター

名前 キー 必須 型 説明
ぺージ
 page integer

取得するページ オフセット。
アイテム
 items integer

ページごとに返される項目の数。

戻り値

返答
array of User

定義

Userユーザー

名前 パス 型 説明
ID
 id integer

識別子
First Name
 first_name string

名。
Last Name
 last_name string

姓。

Group

名前 パス 型 説明
ID
 id integer

識別子
件名
 name string

名前。
プロパティ
 description string

説明設定。
アクセシビリティ
 accessibility string

アクセスビリティ。

Property

名前 パス 型 説明
ID
 id integer

識別子
件名
 name string

名前。
タイプ
 type string

種類。
記事の既定
 default_for_articles boolean

記事をデフォルトにするかどうか。
meta
 meta PropertyMeta
プロパティ値
 property_values array of PropertyValue

PropertyMeta

名前 パス 型 説明
Number Format
 number_format string

タイプ番号のプロパティにのみ返され、関連します。
日付の表示形式
 date_format string

タイプ日付のプロパティにのみ返され、関連します
複数の人物へのメンションを許可する
 allow_mentioning_multiple_people boolean

タイプ人物のプロパティにのみ返され、関連します。
通知する人
 notify_person boolean

タイプ人物のプロパティにのみ返され、関連します。

PropertyValue

名前 パス 型 説明
ID
 id integer

識別子
プロパティ ID
 property_id integer

プロパティ識別子。
価値
 value string

値。
meta
 meta PropertyValueMeta

PropertyValueMeta

名前 パス 型 説明
カラー
 color string

single_select および multi_select タイプのプロパティにのみ返され、関連します。

HandbookItem

名前 パス 型 説明
ID
 id integer

識別子
ハンドブック ID
 handbook_id integer

ハンドブックの識別子。
タイプ
 type string

種類。
Position
 position integer

ポジション。
肩書き
 title string

セクション項目とリンク項目に対してのみ関連。
[URL]
 url string

リンク項目に対してのみ関連。
親品目 ID
 parent_item_id integer

項目がネストされている場合は null 以外。
ドキュメント ID
 doc_id integer

ドキュメント項目にのみ関連です。

ハンドブック

名前 パス 型 説明
ID
 id integer

識別子
件名
 name string

名前。

Folder

名前 パス 型 説明
ID
 id integer

識別子
肩書き
 title string

肩書き。
Workspace ID
 workspace_id integer

ワークスペース識別子。
親フォルダー ID
 parent_folder_id integer

親フォルダー識別子。

DocAccess

名前 パス 型 説明
ID
 id integer

識別子
ドキュメント ID
 doc_id integer

ドキュメントの識別子。
Permission
 permission string

アクセス許可。
アクセサーのタイプ
 accessor_type string

アクセサーのタイプ。
アクセサー ID
 accessor_id integer

アクセサーの識別子。
継承済み
 inherited boolean

継承済みかどうか。

DocProperty

名前 パス 型 説明
ID
 id integer

識別子
プロパティ モデル
 property Property
価値
 value string

value のタイプはプロパティのタイプによって異なります: 'text', 'date'、'number'、'link' => String 'single_select' => { 'selected_item_id': Integer }、PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }、選択した PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }、Document#ID 'person' => { 'user_ids': Array[Integer] }、User#ID。

ドキュメント

名前 パス 型 説明
ID
 id integer

識別子
肩書き
 title string

肩書き。
Workspace ID
 workspace_id integer

ワークスペース識別子。
フォルダー ID
 folder_id integer

フォルダー識別子。
Owner ID
 owner_id integer

ドキュメントの所有者のユーザー ID。
作成日
 created_at string

ISO8601 形式の datetime。
更新日
 updated_at string

ISO8601 形式の datetime。

Import

名前 パス 型 説明
ID
 id integer

識別子
ステータス
 status string
ドキュメント モデル
 doc Doc