概念 (独立した発行元)

Notion コネクタでは、API を使用して、Notion のページ、データベース、およびユーザーにアクセスします。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 チャンドラ・セカール & ハルシニ・ヴァルマ
URL https://github.com/sekharmalla
Email chandra.malla@msftcommunity.com
コネクタ メタデータ
Publisher チャンドラ・セカール & ハルシニ・ヴァルマ
Website https://www.notion.so/
プライバシー ポリシー https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
カテゴリ 生産性;コラボレーション

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

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

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

名前 タイプ Description 必須
API キー securestring この API の API キー 正しい

調整制限

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

アクション

Search

統合と共有されているすべてのページと子ページを検索します。 結果にはデータベースが含まれる場合があります。
すべてのユーザーの一覧

ワークスペースのユーザーのページ分割された一覧を返します
コメントを作成する

ページまたは既存のディスカッション スレッドにコメントを作成します。
コメントを取得する

解決されていない Comment オブジェクトの一覧をページまたはブロックから取得します。
データベースのクエリを実行する

要求で指定されたフィルター条件と並べ替え条件に従ってフィルター処理および並べ替えられた、データベースに含まれる Pages の一覧を取得します。
データベースを取得する

指定した ID を使用して Database オブジェクトを取得します。
トークンのボット ユーザーを取得する

承認ヘッダーで指定された API トークンに関連付けられているボット ユーザーを取得します。 ボットには、統合を承認したユーザーに関する情報を含む所有者フィールドがあります。
ブロックの子を取得する

指定された ID を使用して、ブロックに含まれる子ブロック オブジェクトのページ分割された配列を返します。
ブロックの子を追加する

指定した親block_idに新しい子ブロックを作成して追加します。
ブロックを削除する

指定した ID を使用して、ページ ブロックを含む Block オブジェクトをアーカイブ済み : true に設定します。 注: Notion UI アプリケーションでは、ブロックは引き続きアクセスおよび復元できる "ごみ箱" に移動します。
ブロックを取得する

指定した ID を使用して Block オブジェクトを取得します。
ブロックを更新する

ブロックの種類に基づいて、指定したblock_idのコンテンツを更新します。 ブロック オブジェクトの種類に基づいてサポートされるフィールド
ページ プロパティ項目を取得する

ページ プロパティ項目を取得する
ページを作成する

指定したデータベースに新しいページを作成します。 既存のページ。
ページを取得する

指定した ID を使用して Page オブジェクトを取得します。
ユーザーの取得

指定した ID を使用してユーザーを取得します。
操作 ID:
Search

統合と共有されているすべてのページと子ページを検索します。 結果にはデータベースが含まれる場合があります。

パラメーター

名前 キー 必須 型 説明
Query
 query True string

指定した場合、クエリをページ タイトルと比較して返されるページを制限します。
通信方向
 direction string

並べ替える方向。 使用できる値は、昇順と降順です。
タイムスタンプ
 timestamp string

並べ替えの対象となるタイムスタンプの名前。 指定できる値には、last_edited_timeが含まれます。

戻り値

名前 パス 型 説明
id
 id string

ブロックの識別子。
作成時間
 created_time string

このページが作成された日時。
最終編集時刻
 last_edited_time string

このページが更新された日時。
プレーンテキスト ファイル
 plain_text string

注釈のないプレーン テキスト。
タグ
 Tags object

tags オブジェクトには、タグの一覧が含まれています。
URL
 url string

オブジェクトの URL。
次のカーソル
 next_cursor string

返されたカーソルは、結果の次のページを要求するために使用されます。 これを不透明な値として扱う
その他
 has_more boolean

ブロックのブロック数が多いかどうか

すべてのユーザーの一覧

操作 ID:
List_of_all_users

ワークスペースのユーザーのページ分割された一覧を返します

パラメーター

名前 キー 必須 型 説明
ページ サイズ
 page_size integer

応答で必要な完全なリストの項目の数。 最大: 100

戻り値

名前 パス 型 説明
ID (アイディー)
 id string

Notion ブロックの識別子
表示される名前
 name string

ユーザーの名前が Notion に表示されます。
アバター URL
 avatar_url string

選択したアバター画像。
タイプ
 type string

ユーザーの種類。 指定できる値は、"person" と "bot" です。
Email
 email string

ユーザーのメール アドレス。
次のカーソル
 next_cursor string

返されたカーソルは、結果の次のページを要求するために使用されます。 これを不透明な値として扱う
その他
 has_more boolean

応答にリストの末尾が含まれている場合

コメントを作成する

操作 ID:
Createcomment

ページまたは既存のディスカッション スレッドにコメントを作成します。

パラメーター

名前 キー 必須 型 説明
ページ ID
 page_id string

ページの識別子
ディスカッション ID
 discussion_id string

Notion ブロックの識別子
Content
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。

戻り値

Body
CommentResponse

コメントを取得する

操作 ID:
Retrievecomments

解決されていない Comment オブジェクトの一覧をページまたはブロックから取得します。

パラメーター

名前 キー 必須 型 説明
ブロック ID
 block_id True string

Notion ブロックまたはページの識別子

戻り値

Body
CommentResponse

データベースのクエリを実行する

操作 ID:
Query_a_database

要求で指定されたフィルター条件と並べ替え条件に従ってフィルター処理および並べ替えられた、データベースに含まれる Pages の一覧を取得します。

パラメーター

名前 キー 必須 型 説明
データベース ID
 database_id True string

Notion データベースの識別子。

戻り値

Body
DatabaseResponse

データベースを取得する

操作 ID:
Retrieve_a_database

指定した ID を使用して Database オブジェクトを取得します。

パラメーター

名前 キー 必須 型 説明
データベース ID
 database_id True string

Notion データベースの識別子

戻り値

Body
DatabaseResponse

トークンのボット ユーザーを取得する

操作 ID:
RetrieveYourTokensBotUser

承認ヘッダーで指定された API トークンに関連付けられているボット ユーザーを取得します。 ボットには、統合を承認したユーザーに関する情報を含む所有者フィールドがあります。

戻り値

名前 パス 型 説明
ID (アイディー)
 id string

このユーザーの一意識別子。
名前
 name string

[Notion]\(概念\) に表示されるユーザーの名前。
アバター URL
 avatar_url string

選択したアバター画像。
タイプ
 type string

ユーザーの種類。 指定できる値は、"person" と "bot" です。
所有者の種類
 bot.owner.type string

所有者の種類 ( "ワークスペース" または "ユーザー" のいずれか)。

ブロックの子を取得する

操作 ID:
Retrieve_block_children

指定された ID を使用して、ブロックに含まれる子ブロック オブジェクトのページ分割された配列を返します。

パラメーター

名前 キー 必須 型 説明
ブロック ID
 block_id True string

ブロックの識別子
ページ サイズ
 page_size integer

応答で必要な完全なリストの項目の数。 最大: 100

戻り値

名前 パス 型 説明
id
 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

ブロックのブロック数が多いかどうか

ブロックの子を追加する

操作 ID:
Appendblockchildren

指定した親block_idに新しい子ブロックを作成して追加します。

パラメーター

名前 キー 必須 型 説明
ブロック ID
 block_id True string

ブロックの識別子
オブジェクト
 object string

オブジェクト
型
 type string

型
型
 type string

型
コンテンツ
 content string

コンテンツ
型
 type string

型
コンテンツ
 content string

コンテンツ
URL
 url string

URL

ブロックを削除する

操作 ID:
Deleteablock

指定した ID を使用して、ページ ブロックを含む Block オブジェクトをアーカイブ済み : true に設定します。 注: Notion UI アプリケーションでは、ブロックは引き続きアクセスおよび復元できる "ごみ箱" に移動します。

パラメーター

名前 キー 必須 型 説明
ブロック ID
 blockId True string

Notion ブロックの識別子

戻り値

名前 パス 型 説明
id
 id string

ブロックの識別子。
作成時間
 created_time date-time

このブロックが作成された日時。
最終編集時刻
 last_edited_time date-time

このブロックが最後に更新された日時。
Object
 created_by.object string

常に "ユーザー"
ID (アイディー)
 created_by.id string

このユーザーの一意識別子。
Object
 last_edited_by.object string

最後に編集されたユーザー
ID (アイディー)
 last_edited_by.id string

このユーザーの一意識別子。
子を持っている
 has_children boolean

ブロック内に子ブロックが入れ子になっているかどうか。
Archived
 archived boolean

ブロックのアーカイブ済み状態。
タイプ
 type string

型固有のブロック情報を含むオブジェクト

ブロックを取得する

操作 ID:
Retrieveablock

指定した ID を使用して Block オブジェクトを取得します。

パラメーター

名前 キー 必須 型 説明
ブロック ID
 blockId True string

ブロックの識別子。

戻り値

名前 パス 型 説明
オブジェクト
 object string

オブジェクト
id
 id string

ブロックの識別子。
作成時間
 created_time date-time

このブロックが作成された日時。
最終編集時刻
 last_edited_time date-time

このブロックが最後に更新された日時。
Object
 created_by.object string

常に "ユーザー"
ID (アイディー)
 created_by.id string

このユーザーの一意識別子。
Object
 last_edited_by.object string

最後に編集されたユーザー
ID (アイディー)
 last_edited_by.id string

このユーザーの一意識別子。
子を持っている
 has_children boolean

ブロック内に子ブロックが入れ子になっているかどうか。
Archived
 archived boolean

ブロックのアーカイブ済み状態。
タイプ
 type string

型固有のブロック情報を含むオブジェクト

ブロックを更新する

操作 ID:
Updateablock

ブロックの種類に基づいて、指定したblock_idのコンテンツを更新します。 ブロック オブジェクトの種類に基づいてサポートされるフィールド

パラメーター

名前 キー 必須 型 説明
ブロック ID
 blockId True string

Notion ブロックの識別子
Content
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

ブロックの色。
Content
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

ブロックの色。
Content
 content string

テキスト content2。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

ブロックの色。
Content
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

色
Contents1
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

ブロックの色。
Contents1
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
色
 color string

ブロックの色。
Contents1
 content string

テキスト コンテンツ。 このフィールドにはテキストの実際の内容が含まれており、おそらく最も頻繁に使用するフィールドです。
確認済み
 checked boolean

to_doがチェックされているかどうか。
色
 color string

ブロックの色。

ページ プロパティ項目を取得する

操作 ID:
Retrieveapagepropertyitem

ページ プロパティ項目を取得する

パラメーター

名前 キー 必須 型 説明
ページ ID
 page_id True string

[概念] ページの識別子
プロパティ ID
 property_id True string

ページ プロパティの識別子

戻り値

名前 パス 型 説明
Object
 object string

常に一覧表示します。
その他
 has_more boolean

応答にリストの末尾が含まれている場合は false。 それ以外の場合は true。

ページを作成する

操作 ID:
CreateaPage

指定したデータベースに新しいページを作成します。 既存のページ。

パラメーター

名前 キー 必須 型 説明
データベース ID
 database_id True string

データベースの一意識別子。
Emoji
 emoji string

emoji
カバー URL
 url string

ページカバー画像の URL。
プロパティ
 properties object

Notion に表示されるデータベースのプロパティのスキーマ。

戻り値

名前 パス 型 説明
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

外部でホストされているイメージへのリンク。
emoji
 icon.emoji string

絵文字文字。
データベースID
 parent.database_id string

データベースID
アーカイブ
 archived boolean

ページのアーカイブ済み状態。
URL
 url string

[概念] ページの URL。

ページを取得する

操作 ID:
Retrieveapage

指定した ID を使用して Page オブジェクトを取得します。

パラメーター

名前 キー 必須 型 説明
ページ ID
 page_id True string

[概念] ページの識別子

戻り値

名前 パス 型 説明
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

外部でホストされているイメージへのリンク。
emoji
 icon.emoji string

絵文字文字。
データベースID
 parent.database_id string

データベースID
アーカイブ
 archived boolean

ページのアーカイブ済み状態。
URL
 url string

[概念] ページの URL。

ユーザーの取得

操作 ID:
Retrieveuser

指定した ID を使用してユーザーを取得します。

パラメーター

名前 キー 必須 型 説明
ユーザーID
 user_id True string

このユーザーの一意識別子。

戻り値

名前 パス 型 説明
ID (アイディー)
 id string

Notion ユーザーの識別子
ユーザー名
 name string

ユーザーの名前
アバター URL
 avatar_url string

選択したアバター画像
Email
 email string

ユーザーのメール アドレス。

定義

CommentResponse

名前 パス 型 説明
ID (アイディー)
 id string

コメントの一意識別子。
ページ ID
 parent.page_id string

このページが属するページの ID。
ディスカッション ID
 discussion_id string

コメントが関連付けられているディスカッション スレッドの一意識別子。
作成時間
 created_time string

このコメントが作成された日時。
最終編集時刻
 last_edited_time string

このコメントが更新された日時。
オブジェクト
 created_by.object string

オブジェクト
id
 created_by.id string

id
リッチ テキスト
 rich_text array of object

リッチ テキストの書式設定、リンク、メンションをサポートするコメントの内容。
型
 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 (存在する場合)。

DatabaseResponse

名前 パス 型 説明
results
 results array of object
Object
 results.object string

ページまたは 'データベース'
ID (アイディー)
 results.id string

データベースの一意識別子。
作成時間
 results.created_time string

このデータベースが作成された日時。 ISO 8601 日付時刻文字列として書式設定されます。
最終編集時刻
 results.last_edited_time string

このデータベースが更新された日時。 ISO 8601 日付時刻文字列として書式設定されます。
Object
 results.created_by.object string

データベースを作成したユーザー。
ID (アイディー)
 results.created_by.id string

ユーザーの一意識別子
Object
 results.last_edited_by.object string

データベースを作成したユーザー。
ID (アイディー)
 results.last_edited_by.id string

ユーザーの一意識別子
Archived
 results.archived boolean

データベースのアーカイブ済み状態。
URL
 results.url string

Notion データベースの URL