ページを作成
POST/v1/pages既存のページまたはデータベースの子である新しいページを作成します。
新しいページが既存のページの子である場合、 propertiesbody パラメータ で有効なプロパティは titleだけです 。
新しいページが既存のデータベースの子である場合、propertiesオブジェクトの body パラメータのキーは、 親 データベースのプロパティと一致する必要があります。
このエンドポイントは、childrenオプションを使用して、コンテンツの有無にかかわらず新しいページを作成するために使用できます。作成後にページにコンテンツを追加するには、Append block childrenエンドポイントを使用します。
新しいページ オブジェクトを返します。
🚧一部のページ
propertiesはAPI 経由でサポートされていません。プロパティ オブジェクトに
rollup、created_by、created_time、last_edited_by、またはlast_edited_time値を含む要求本文は、エラーを返します。これらの Notion によって生成された値は、API を介して作成または更新することはできません。parentにこれらのプロパティのいずれかが含まれている場合、新しいページの対応する値が自動的に作成されます。
📘要件
このエンドポイントを呼び出すには、統合にターゲットの親ページまたはデータベースのコンテンツ更新機能が必要です。統合機能を更新するには、[マイインテグレーション]ダッシュボードに移動し、統合を選択して**[機能]**タブに移動し、必要に応じて設定を更新します。
コンテンツ更新機能なしでクエリを試行すると、403 ステータス コードを含む HTTP 応答が返されます。
Requestパラメータ
新しいページが挿入される親ページまたはデータベースは、page_idまたはdatabase_idキー、および対応するIDを持つJSONオブジェクトとして表されます。
新しいページのアイコン。絵文字オブジェクトまたは外部ファイルオブジェクトのいずれか。
ファイルオブジェクトとして表される新しいページのカバー画像。
ページのプロパティの値。親がデータベースの場合、スキーマは親データベースのプロパティと一致する必要があります。親がページの場合、有効なオブジェクトキーはタイトルのみです。
新しいページでレンダリングされるコンテンツは、ブロックオブジェクトの配列として表されます。
{
"parent": {
"database_id": "string"
},
"icon": {
"emoji": "string"
},
"cover": {
"external": {
"url": "string"
}
},
"properties": {
"Name": {
"title": [
{
"text": {
"content": "string"
}
}
]
},
"Description": {
"rich_text": [
{
"text": {
"content": "string"
}
}
]
},
"Food group": {
"select": {
"name": "string"
}
},
"Price": {
"number": 0
}
},
"children": [
{
"object": "string",
"type": "string",
"heading_2": {
"rich_text": [
{
"type": "string",
"text": {
"content": "string"
}
}
]
},
"paragraph": {
"rich_text": [
{
"type": "string",
"text": {
"content": "string",
"link": {
"url": "string"
}
}
}
]
}
}
]
}サンプルコード
Response
{
"object": "page",
"id": "59833787-2cf9-4fdf-8782-e53db20768a5",
"created_time": "2022-03-01T19:05:00.000Z",
"last_edited_time": "2022-07-06T19:16:00.000Z",
"created_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"last_edited_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"cover": {
"type": "external",
"external": {
"url": "https://upload.wikimedia.org/wikipedia/commons/6/62/Tuscankale.jpg"
}
},
"icon": {
"type": "emoji",
"emoji": "🥬"
},
"parent": {
"type": "database_id",
"database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
},
"archived": false,
"properties": {
"Store availability": {
"id": "%3AUPp"
},
"Food group": {
"id": "A%40Hk"
},
"Price": {
"id": "BJXS"
},
"Responsible Person": {
"id": "Iowm"
},
"Last ordered": {
"id": "Jsfb"
},
"Cost of next trip": {
"id": "WOd%3B"
},
"Recipes": {
"id": "YfIu"
},
"Description": {
"id": "_Tc_"
},
"In stock": {
"id": "%60%5Bq%3F"
},
"Number of meals": {
"id": "zag~"
},
"Photo": {
"id": "%7DF_L"
},
"Name": {
"id": "title"
}
},
"url": "https://www.notion.so/Tuscan-Kale-598337872cf94fdf8782e53db20768a5"
}