Notion (独立発行者)
Notion コネクタは API を使用して、Notion のページ、データベース、ユーザーにアクセスします。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Chandra Sekhar & Harshini Varma |
| [URL] | https://github.com/sekharmalla |
| メール | chandra.malla@msftcommunity.com |
| Connector Metadata | |
|---|---|
| 発行者 | Chandra Sekhar & Harshini Varma |
| Web サイト | https://www.notion.so/ |
| プライバシー ポリシー | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| カテゴリ | 生産性; コラボレーション |
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | この API の API キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべてのユーザーの一覧 |
ワークスペースのユーザーのページ分割された一覧を返します |
| コメントを作成する |
ページまたは既存のディスカッション スレッドにコメントを作成します。 |
| コメントを取得する |
ページまたはブロックから未解決の Comment オブジェクトのリストを取得します。 |
| データベースにクエリを実行する |
データベースに含まれるページのリストを取得し、リクエストで指定されたフィルター条件と並べ替え基準に従ってフィルター処理および並べ替えを行います。 |
| データベースを取得する |
指定された ID を使用してデータベース オブジェクトを取得します。 |
| トークンのボット ユーザーを取得する |
Authorization ヘッダーで提供された API トークンに関連付けられたボット ユーザーを取得します。 このボットには、統合を承認した人物に関する情報を含む所有者フィールドがあります。 |
| ブロックの削除 |
指定された ID を使用して、ページ ブロックを含む Block オブジェクトを archived: true に設定します。 注: Notion UI アプリケーションでは、ブロックは "ゴミ箱" に移動され、引き続きアクセスして復元することができます。 |
| ブロックの取得 |
指定された ID を使用してブロック オブジェクトを取得します。 |
| ブロックの子をアペンドする |
新しい子ブロックを作成し、指定された親 block_id に追加します。 |
| ブロックの子を取得する |
指定された ID を使用して、ブロックに含まれる子ブロック オブジェクトのページ分割された配列を返します |
| ブロックを更新する |
ブロックの種類に基づいて、指定された block_id のコンテンツを更新します。 ブロック オブジェクト タイプに基づいてサポートされるフィールド |
| ページ プロパティ アイテムを取得する |
ページ プロパティ アイテムを取得する |
| ページの作成 |
指定したデータベースで新しいページを作成します。 既存のページ。 |
| ページを取得する |
指定された ID を使用してページ オブジェクトを取得します。 |
| ユーザーの取得 |
指定された ID を使用してユーザーを取得します。 |
| 検索する |
統合と共有されているすべてのページと子ページを検索します。 結果にはデータベースが含まれる場合があります。 |
すべてのユーザーの一覧
ワークスペースのユーザーのページ分割された一覧を返します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ページ サイズ
|
page_size | integer |
応答で必要な完全な一覧の項目数。 最大: 100 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Id
|
id | string |
Notion ブロックの識別子 |
|
表示名
|
name | string |
Notion に表示されるユーザーの名前。 |
|
Avatar URL
|
avatar_url | string |
選択したアバター画像。 |
|
タイプ
|
type | string |
ユーザーの種類。 指定できる値は、「ユーザー」および「ボット」です。 |
|
Email
|
string |
ユーザーのメール アドレス。 |
|
|
次のカーソル
|
next_cursor | string |
結果の次のページを要求するために使用される、返されたカーソル。 これを不透明な値として扱います |
|
続きがあるかどうか
|
has_more | boolean |
応答に一覧の末尾が含まれている場合 |
コメントを作成する
ページまたは既存のディスカッション スレッドにコメントを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ページ ID
|
page_id | string |
ページの識別子 |
|
|
Discussion ID
|
discussion_id | string |
Notion ブロックの識別子 |
|
|
Content
|
content | string |
テキスト コンテンツ。 このフィールドにはテキストの実際のコンテンツが含まれており、おそらく最も頻繁に使用するフィールドです。 |
戻り値
- Body
- CommentResponse
コメントを取得する
ページまたはブロックから未解決の Comment オブジェクトのリストを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Block Id
|
block_id | True | string |
Notion ブロックまたはページの識別子 |
戻り値
- Body
- CommentResponse
データベースにクエリを実行する
データベースに含まれるページのリストを取得し、リクエストで指定されたフィルター条件と並べ替え基準に従ってフィルター処理および並べ替えを行います。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Database ID
|
database_id | True | string |
Notion データベースの識別子。 |
戻り値
- Body
- DatabaseResponse
データベースを取得する
指定された ID を使用してデータベース オブジェクトを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Database id
|
database_id | True | string |
Notion データベースの識別子 |
戻り値
- Body
- DatabaseResponse
トークンのボット ユーザーを取得する
Authorization ヘッダーで提供された API トークンに関連付けられたボット ユーザーを取得します。 このボットには、統合を承認した人物に関する情報を含む所有者フィールドがあります。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Id
|
id | string |
このユーザーを表す一意識別子。 |
|
件名
|
name | string |
Notion に表示されるユーザーの名前。 |
|
Avatar url
|
avatar_url | string |
選択したアバター画像。 |
|
タイプ
|
type | string |
ユーザーの種類。 指定できる値は、「ユーザー」および「ボット」です。 |
|
Owner type
|
bot.owner.type | string |
所有者のタイプ - "ワークスペース" または "ユーザー" のいずれか。 |
ブロックの削除
指定された ID を使用して、ページ ブロックを含む Block オブジェクトを archived: true に設定します。 注: Notion UI アプリケーションでは、ブロックは "ゴミ箱" に移動され、引き続きアクセスして復元することができます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Block 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 |
Last edited user |
|
Id
|
last_edited_by.id | string |
このユーザーを表す一意識別子。 |
|
子の存在
|
has_children | boolean |
ブロック内にネストされた子ブロックがあるかどうか。 |
|
Archived
|
archived | boolean |
ブロックのアーカイブ状態。 |
|
タイプ
|
type | string |
タイプ固有のブロック情報を含むオブジェクト |
ブロックの取得
指定された 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 |
Last edited user |
|
Id
|
last_edited_by.id | string |
このユーザーを表す一意識別子。 |
|
子の存在
|
has_children | boolean |
ブロック内にネストされた子ブロックがあるかどうか。 |
|
Archived
|
archived | boolean |
ブロックのアーカイブ状態。 |
|
タイプ
|
type | string |
タイプ固有のブロック情報を含むオブジェクト |
ブロックの子をアペンドする
新しい子ブロックを作成し、指定された親 block_id に追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Block id
|
block_id | True | string |
ブロックの識別子 |
|
オブジェクト
|
object | string |
オブジェクト |
|
|
タイプ
|
type | string |
タイプ |
|
|
タイプ
|
type | string |
タイプ |
|
|
コンテント
|
content | string |
コンテント |
|
|
タイプ
|
type | string |
タイプ |
|
|
コンテント
|
content | string |
コンテント |
|
|
url
|
url | string |
url |
ブロックの子を取得する
指定された ID を使用して、ブロックに含まれる子ブロック オブジェクトのページ分割された配列を返します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Block 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 |
ブロック内にネストされた子ブロックがあるかどうか。 |
|
アーカイブ済み
|
items.archived | boolean |
ブロックのアーカイブ状態。 |
|
タイプ
|
items.type | string |
ブロックの種類。 指定できる値 |
|
プレーン テキスト
|
plain_text | string |
plain_text 段落ブロックのプレーン テキスト |
|
次のカーソル
|
next_cursor | string |
結果の次のページを要求するために使用される、返されたカーソル。 これを不透明な値として扱います |
|
続きがあるかどうか
|
has_more | boolean |
このブロックの続きにブロックがあるかどうか |
ブロックを更新する
ブロックの種類に基づいて、指定された block_id のコンテンツを更新します。 ブロック オブジェクト タイプに基づいてサポートされるフィールド
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Block ID
|
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 |
色 |
|
|
Contents1
|
content | string |
テキスト コンテンツ。 このフィールドにはテキストの実際のコンテンツが含まれており、おそらく最も頻繁に使用するフィールドです。 |
|
|
カラー
|
color | string |
ブロックの色。 |
|
|
Contents1
|
content | string |
テキスト コンテンツ。 このフィールドにはテキストの実際のコンテンツが含まれており、おそらく最も頻繁に使用するフィールドです。 |
|
|
カラー
|
color | string |
ブロックの色。 |
|
|
Contents1
|
content | string |
テキスト コンテンツ。 このフィールドにはテキストの実際のコンテンツが含まれており、おそらく最も頻繁に使用するフィールドです。 |
|
|
選択済みです
|
checked | boolean |
to_do がチェック済みかどうかを示します。 |
|
|
カラー
|
color | string |
ブロックの色。 |
ページ プロパティ アイテムを取得する
ページ プロパティ アイテムを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ページ ID
|
page_id | True | string |
Notion ページの識別子 |
|
プロパティ ID
|
property_id | True | string |
ページ プロパティの識別子 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Object
|
object | string |
常に表示。 |
|
続きがあるかどうか
|
has_more | boolean |
応答に一覧の末尾が含まれている場合、false。 それ以外は、true。 |
ページの作成
指定したデータベースで新しいページを作成します。 既存のページ。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Database ID
|
database_id | True | string |
データベースの一意の識別子。 |
|
Emoji
|
emoji | string |
emoji |
|
|
Cover 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 |
絵文字の文字。 |
|
database_id
|
parent.database_id | string |
database_id |
|
archived
|
archived | boolean |
ページのアーカイブ状態。 |
|
[URL]
|
url | string |
Notion ページの URL。 |
ページを取得する
指定された ID を使用してページ オブジェクトを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ページ ID
|
page_id | True | string |
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 |
絵文字の文字。 |
|
database_id
|
parent.database_id | string |
database_id |
|
archived
|
archived | boolean |
ページのアーカイブ状態。 |
|
[URL]
|
url | string |
Notion ページの URL。 |
ユーザーの取得
指定された ID を使用してユーザーを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
User ID
|
user_id | True | string |
このユーザーを表す一意識別子。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Id
|
id | string |
Notion ユーザーの識別子 |
|
User Name
|
name | string |
ユーザーの名前 |
|
Avatar URL
|
avatar_url | string |
選択したアバター画像 |
|
メール
|
string |
ユーザーのメール アドレス。 |
検索する
統合と共有されているすべてのページと子ページを検索します。 結果にはデータベースが含まれる場合があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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 |
タグ オブジェクトには、タグの一覧が含まれています。 |
|
URL
|
url | string |
オブジェクトの URL。 |
|
次のカーソル
|
next_cursor | string |
結果の次のページを要求するために使用される、返されたカーソル。 これを不透明な値として扱います |
|
続きがあるかどうか
|
has_more | boolean |
このブロックの続きにブロックがあるかどうか |
定義
CommentResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Id
|
id | string |
コメントの一意識別子。 |
|
ページ ID
|
parent.page_id | string |
このページが属するページの ID。 |
|
Discussion 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 |