ブロックの子を取得
GET/v1/blocks/{block_id}/children指定された ID を使用して、ブロックに含まれる子ブロック オブジェクトのページ分割された配列を返します。ブロックの完全な表現を取得するには、子ブロックの子ブロックを再帰的に取得する必要がある場合があります。
🚧
指定されたブロックの最初のレベルの子のみを返します。ブロックにネストされた子があるかどうかを判断する方法の詳細については、ブロック オブジェクトを参照してください。
応答に含まれる結果はpage_size 個より少ない場合があります。
カーソルを使用してリストを反復処理する方法の詳細については、ページネーションを参照してください。
📘統合機能
このエンドポイントでは、コンテンツの読み取り機能を備えた統合が必要です。コンテンツの読み取り機能なしでこの API を呼び出そうとすると、403 ステータス コードを含む HTTP 応答が返されます。統合機能の詳細については、機能ガイドを参照してください。
エラー
idで指定されたブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。
リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。
Requestパラメータ
Pathパラメータ
block_id
string
必須
ブロックの識別子
Queryパラメータ
page_size
string
可選
応答で必要な完全なリストからのアイテムの数。最大: 100
start_cursor
string
可選
指定されている場合、このエンドポイントは、指定されたカーソルの後に始まる結果のページを返します。指定しない場合、このエンドポイントは結果の最初のページを返します。
Headerパラメータ
Notion-Version
string
必須
サンプルコード
Response
200 Success - Retrieve block children(200)
200 Success - Retrieve block children
HTTPステータスコード: 200
コンテンツ形式: JSONapplication/json
データ構造
has_more
boolean
必須
next_cursor
null
必須
object
string
必須
results
array [object {13}]
必須
created_time
string
必須
has_children
boolean
必須
id
string
必須
last_edited_time
string
必須
object
string
必須
type
string
必須
unsupported
object
可選
parent
object
必須
created_by
object
必須
last_edited_by
object
必須
archived
boolean
必須
heading_2
object
可選
paragraph
object
可選
type
string
必須
block
object
必須
例成功例
{
"object": "list",
"results": [
{
"object": "block",
"id": "c02fc1d3-db8b-45c5-a222-27595b15aea7",
"parent": {
"type": "page_id",
"page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
},
"created_time": "2022-03-01T19:05:00.000Z",
"last_edited_time": "2022-03-01T19:05:00.000Z",
"created_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"last_edited_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"has_children": false,
"archived": false,
"type": "heading_2",
"heading_2": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Lacinato kale",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Lacinato kale",
"href": null
}
],
"color": "default",
"is_toggleable": false
}
},
{
"object": "block",
"id": "acc7eb06-05cd-4603-a384-5e1e4f1f4e72",
"parent": {
"type": "page_id",
"page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
},
"created_time": "2022-03-01T19:05:00.000Z",
"last_edited_time": "2022-03-01T19:05:00.000Z",
"created_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"last_edited_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"has_children": false,
"archived": false,
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
"link": {
"url": "https://en.wikipedia.org/wiki/Lacinato_kale"
}
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
"href": "https://en.wikipedia.org/wiki/Lacinato_kale"
}
],
"color": "default"
}
}
],
"next_cursor": null,
"has_more": false,
"type": "block",
"block": {}
}最終更新： 2 years ago