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

データベースを作成

POST
/v1/databases
データベースを作成します。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.notion.com/v1/databases' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parent": {
        "type": "string",
        "page_id": "string"
    },
    "icon": {
        "type": "string",
        "emoji": "string"
    },
    "cover": {
        "type": "string",
        "external": {
            "url": "string"
        }
    },
    "title": [
        {
            "type": "string",
            "text": {
                "content": "string",
                "link": null
            }
        }
    ],
    "properties": {
        "Name": {
            "title": {}
        },
        "Description": {
            "rich_text": {}
        },
        "In stock": {
            "checkbox": {}
        },
        "Food group": {
            "select": {
                "options": [
                    {
                        "name": "string",
                        "color": "string"
                    }
                ]
            }
        },
        "Price": {
            "number": {
                "format": "string"
            }
        },
        "Last ordered": {
            "date": {}
        },
        "Meals": {
            "relation": {
                "database_id": "string",
                "single_property": {}
            }
        },
        "Number of meals": {
            "rollup": {
                "rollup_property_name": "string",
                "relation_property_name": "string",
                "function": "string"
            }
        },
        "Store availability": {
            "type": "string",
            "multi_select": {
                "options": [
                    {
                        "name": "string",
                        "color": "string"
                    }
                ]
            }
        },
        "+1": {
            "people": {}
        },
        "Photo": {
            "files": {}
        }
    }
}'
Response Response Example
{
    "object": "database",
    "id": "bc1211ca-e3f1-4939-ae34-5260b16f627c",
    "created_time": "2021-07-08T23:50:00.000Z",
    "last_edited_time": "2021-07-08T23:50:00.000Z",
    "icon": {
        "type": "emoji",
        "emoji": "🎉"
    },
    "cover": {
        "type": "external",
        "external": {
            "url": "https://website.domain/images/image.png"
        }
    },
    "url": "https://www.notion.so/bc1211cae3f14939ae34260b16f627c",
    "title": [
        {
            "type": "text",
            "text": {
                "content": "Grocery List",
                "link": null
            },
            "annotations": {
                "bold": false,
                "italic": false,
                "strikethrough": false,
                "underline": false,
                "code": false,
                "color": "default"
            },
            "plain_text": "Grocery List",
            "href": null
        }
    ],
    "properties": {
        "+1": {
            "id": "Wp%3DC",
            "name": "+1",
            "type": "people",
            "people": {}
        },
        "In stock": {
            "id": "fk%5EY",
            "name": "In stock",
            "type": "checkbox",
            "checkbox": {}
        },
        "Price": {
            "id": "evWq",
            "name": "Price",
            "type": "number",
            "number": {
                "format": "dollar"
            }
        },
        "Description": {
            "id": "V}lX",
            "name": "Description",
            "type": "rich_text",
            "rich_text": {}
        },
        "Last ordered": {
            "id": "eVnV",
            "name": "Last ordered",
            "type": "date",
            "date": {}
        },
        "Meals": {
            "id": "%7DWA~",
            "name": "Meals",
            "type": "relation",
            "relation": {
                "database_id": "668d797c-76fa-4934-9b05-ad288df2d136",
                "single_property": {}
            }
        },
        "Number of meals": {
            "id": "Z\\Eh",
            "name": "Number of meals",
            "type": "rollup",
            "rollup": {
                "rollup_property_name": "Name",
                "relation_property_name": "Meals",
                "rollup_property_id": "title",
                "relation_property_id": "mxp^",
                "function": "count"
            }
        },
        "Store availability": {
            "id": "s}Kq",
            "name": "Store availability",
            "type": "multi_select",
            "multi_select": {
                "options": [
                    {
                        "id": "cb79b393-d1c1-4528-b517-c450859de766",
                        "name": "Duc Loi Market",
                        "color": "blue"
                    },
                    {
                        "id": "58aae162-75d4-403b-a793-3bc7308e4cd2",
                        "name": "Rainbow Grocery",
                        "color": "gray"
                    },
                    {
                        "id": "22d0f199-babc-44ff-bd80-a9eae3e3fcbf",
                        "name": "Nijiya Market",
                        "color": "purple"
                    },
                    {
                        "id": "0d069987-ffb0-4347-bde2-8e4068003dbc",
                        "name": "Gus's Community Market",
                        "color": "yellow"
                    }
                ]
            }
        },
        "Photo": {
            "id": "yfiK",
            "name": "Photo",
            "type": "files",
            "files": {}
        },
        "Food group": {
            "id": "CM%3EH",
            "name": "Food group",
            "type": "select",
            "select": {
                "options": [
                    {
                        "id": "6d4523fa-88cb-4ffd-9364-1e39d0f4e566",
                        "name": "🥦Vegetable",
                        "color": "green"
                    },
                    {
                        "id": "268d7e75-de8f-4c4b-8b9d-de0f97021833",
                        "name": "🍎Fruit",
                        "color": "red"
                    },
                    {
                        "id": "1b234a00-dc97-489c-b987-829264cfdfef",
                        "name": "💪Protein",
                        "color": "yellow"
                    }
                ]
            }
        },
        "Name": {
            "id": "title",
            "name": "Name",
            "type": "title",
            "title": {}
        }
    },
    "parent": {
        "type": "page_id",
        "page_id": "98ad959b-2b6a-4774-80ee-00246fb0ea9b"
    },
    "archived": false
}{
    "object": "database",
    "id": "bc1211ca-e3f1-4939-ae34-5260b16f627c",
    "created_time": "2021-07-08T23:50:00.000Z",
    "last_edited_time": "2021-07-08T23:50:00.000Z",
    "icon": {
        "type": "emoji",
        "emoji": "🎉"
    },
    "cover": {
        "type": "external",
        "external": {
            "url": "https://website.domain/images/image.png"
        }
    },
    "url": "https://www.notion.so/bc1211cae3f14939ae34260b16f627c",
    "title": [
        {
            "type": "text",
            "text": {
                "content": "Grocery List",
                "link": null
            },
            "annotations": {
                "bold": false,
                "italic": false,
                "strikethrough": false,
                "underline": false,
                "code": false,
                "color": "default"
            },
            "plain_text": "Grocery List",
            "href": null
        }
    ],
    "properties": {
        "+1": {
            "id": "Wp%3DC",
            "name": "+1",
            "type": "people",
            "people": {}
        },
        "In stock": {
            "id": "fk%5EY",
            "name": "In stock",
            "type": "checkbox",
            "checkbox": {}
        },
        "Price": {
            "id": "evWq",
            "name": "Price",
            "type": "number",
            "number": {
                "format": "dollar"
            }
        },
        "Description": {
            "id": "V}lX",
            "name": "Description",
            "type": "rich_text",
            "rich_text": {}
        },
        "Last ordered": {
            "id": "eVnV",
            "name": "Last ordered",
            "type": "date",
            "date": {}
        },
        "Meals": {
            "id": "%7DWA~",
            "name": "Meals",
            "type": "relation",
            "relation": {
                "database_id": "668d797c-76fa-4934-9b05-ad288df2d136",
                "synced_property_name": "Related to Grocery List (Meals)"
            }
        },
        "Number of meals": {
            "id": "Z\\Eh",
            "name": "Number of meals",
            "type": "rollup",
            "rollup": {
                "rollup_property_name": "Name",
                "relation_property_name": "Meals",
                "rollup_property_id": "title",
                "relation_property_id": "mxp^",
                "function": "count"
            }
        },
        "Store availability": {
            "id": "s}Kq",
            "name": "Store availability",
            "type": "multi_select",
            "multi_select": {
                "options": [
                    {
                        "id": "cb79b393-d1c1-4528-b517-c450859de766",
                        "name": "Duc Loi Market",
                        "color": "blue"
                    },
                    {
                        "id": "58aae162-75d4-403b-a793-3bc7308e4cd2",
                        "name": "Rainbow Grocery",
                        "color": "gray"
                    },
                    {
                        "id": "22d0f199-babc-44ff-bd80-a9eae3e3fcbf",
                        "name": "Nijiya Market",
                        "color": "purple"
                    },
                    {
                        "id": "0d069987-ffb0-4347-bde2-8e4068003dbc",
                        "name": "Gus's Community Market",
                        "color": "yellow"
                    }
                ]
            }
        },
        "Photo": {
            "id": "yfiK",
            "name": "Photo",
            "type": "files",
            "files": {}
        },
        "Food group": {
            "id": "CM%3EH",
            "name": "Food group",
            "type": "select",
            "select": {
                "options": [
                    {
                        "id": "6d4523fa-88cb-4ffd-9364-1e39d0f4e566",
                        "name": "🥦Vegetable",
                        "color": "green"
                    },
                    {
                        "id": "268d7e75-de8f-4c4b-8b9d-de0f97021833",
                        "name": "🍎Fruit",
                        "color": "red"
                    },
                    {
                        "id": "1b234a00-dc97-489c-b987-829264cfdfef",
                        "name": "💪Protein",
                        "color": "yellow"
                    }
                ]
            }
        },
        "Name": {
            "id": "title",
            "name": "Name",
            "type": "title",
            "title": {}
        }
    },
    "parent": {
        "type": "page_id",
        "page_id": "98ad959b-2b6a-4774-80ee-00246fb0ea9b"
    },
    "archived": false,
    "is_inline": false
}

Requestパラメータ

Headerパラメータ
Notion-Version
string 
必須
Request Bodyパラメータapplication/json
parent
object 
必須
ページの親
type
string 
必須
page_id
string 
必須
icon
object 
可選
type
string 
必須
emoji
string 
必須
cover
object 
可選
type
string 
必須
external
object 
必須
title
array [object {2}] 
可選
Notionに表示されるデータベースのタイトル。リッチテキストオブジェクトの配列。
type
string 
可選
text
object 
可選
properties
object 
必須
データベースのプロパティスキーマ。キーはNotionに表示されるプロパティの名前で、値はプロパティスキーマオブジェクトです。
Name
object 
必須
Description
object 
必須
In stock
object 
必須
Food group
object 
必須
Price
object 
必須
Last ordered
object 
必須
Meals
object 
必須
Number of meals
object 
必須
Store availability
object 
必須
+1
object 
必須
Photo
object 
必須
Examples

Response

🟢200OK
application/json
Body
object
string 
必須
id
string 
必須
created_time
string 
必須
last_edited_time
string 
必須
icon
object 
必須
type
string 
必須
emoji
string 
必須
cover
object 
必須
type
string 
必須
external
object 
必須
url
string 
必須
title
array [object {5}] 
必須
type
string 
可選
text
object 
可選
annotations
object 
可選
plain_text
string 
可選
href
null 
可選
properties
object 
必須
+1
object 
必須
In stock
object 
必須
Price
object 
必須
Description
object 
必須
Last ordered
object 
必須
Meals
object 
必須
Number of meals
object 
必須
Store availability
object 
必須
Photo
object 
必須
Food group
object 
必須
Name
object 
必須
parent
object 
必須
type
string 
必須
page_id
string 
必須
archived
boolean 
必須
更新日時 2023-04-28 10:38:59
前へ
データベースのプロパティを更新する
次へ
データベースを取得
Built with