(日本語版)Notion API - Public Beta
  1. ブロック
(日本語版)Notion API - Public Beta
  • 概要
  • インテグレーション機能
  • リクエスト制限
  • ステータス コード
  • ブロック
  • ユーザー
  • コメント
  • リンク プレビューのUnfurl属性オブジェクト
  • バージョン変更
    • バージョニング
    • バージョンによる変更
  • ページ
    • ページ
    • ページのプロパティ
  • データベース
    • データベース
    • データベースのプロパティ
  • その他
    • 絵文字オブジェクト
    • ファイルオブジェクト
    • 親オブジェクト
    • リッチテキストオブジェクト
  • エンドポイント
    • 認証
      • 認証
      • Tokenを作成
    • ブロック
      • ブロックを取得
        GET
      • ブロックを更新
        PATCH
      • ブロックの子を取得
        GET
      • ブロックの子を追加
        PATCH
      • ブロックを削除
        DELETE
    • データベース
      • データベース エントリのフィルタ
      • データベース エントリの並べ替え
      • データベースのプロパティを更新する
      • データベースを作成
      • データベースを取得
      • データベースを更新
      • データベースにクエリを実行
    • ユーザー
      • 全てユーザーのリストを取得
      • トークンのボットユーザーを取得
      • ユーザーを取得
    • ページ
      • ページをアーカイブ
      • ページを作成
      • ページを取得
      • ページプロパティアイテムを取得
      • ページプロパティを更新
    • コメント
      • コメントを作成
      • コメントを取得
    • 検索
      • タイトルで検索
  1. ブロック

ブロックを取得

GET
/v1/blocks/{block_id}
Blocks
指定された ID を使用してBlock オブジェクトを取得します。

📘#

ブロックにhas_children: true key が含まれている場合は 、Retrieve block childrenエンドポイントを使用して、子のリストを取得します。

📘統合機能#

このエンドポイントでは、コンテンツの読み取り機能を備えた統合が必要です。コンテンツの読み取り機能なしでこの API を呼び出そうとすると、403 ステータス コードを含む HTTP 応答が返されます。統合機能の詳細については、機能ガイドを参照してください。

エラー#

ブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。
リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.notion.com/v1/blocks/'
Response Response Example
{
  "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
  }
}

Requestパラメータ

Pathパラメータ
block_id
string 
必須
Notion ブロックの識別子

Response

🟢200200 Success - Retrieve a block
application/json
Body
object
string 
必須
id
string 
必須
parent
object 
必須
type
string 
必須
page_id
string 
必須
created_time
string 
必須
last_edited_time
string 
必須
created_by
object 
必須
object
string 
必須
id
string 
必須
last_edited_by
object 
必須
object
string 
必須
id
string 
必須
has_children
boolean 
必須
archived
boolean 
必須
type
string 
必須
heading_2
object 
必須
rich_text
array [object {5}] 
必須
color
string 
必須
is_toggleable
boolean 
必須
更新日時 2023-04-28 08:28:13
前へ
Tokenを作成
次へ
ブロックを更新
Built with