# Notion APIでページ内のブロックを追加・更新・削除する方法

## 目次
1. はじめに
2. Notion APIの概要
3. ページにブロックを追加する方法
4. ブロックを更新する方法
5. ブロックを削除する方法
6. 実装例
7. まとめ

## 1. はじめに
Notionは多機能なノートアプリとして知られており、APIを通じてページ内のブロックを動的に管理することができます。本記事では、Notion APIを使用してページ内のブロックを追加、更新、削除する方法を詳しく解説します。

## 2. Notion APIの概要
Notion APIは、外部アプリケーションがNotionデータベースやページ内のコンテンツにアクセスし、操作を行えるように設計されています。APIを使用するには、Notion Developer PortalでAPIキーを取得し、各リクエストにヘッダーとして渡す必要があります。

### 必要な事前準備
- NotionのAPIキーの取得
- 操作対象のページやデータベースのIDを取得

## 3. ページにブロックを追加する方法
Notion APIを使ってブロックを追加する場合、`https://api.notion.com/v1/blocks/parent_id/children`エンドポイントにPOSTリクエストを送ります。リクエストボディには追加するブロックの詳細を含める必要があります。

![img](/mosaic-code.jpg)

## 4. ブロックを更新する方法
ブロックを更新するには、`PATCH`リクエストを`https://api.notion.com/v1/blocks/block_id`に送信します。更新するフィールドと新しいデータをリクエストボディに指定します。

![img](/mosaic-code.jpg)

## 5. ブロックを削除する方法
ブロックを削除する場合、`DELETE`リクエストを`https://api.notion.com/v1/blocks/block_id`に送信します。この操作は指定されたブロックを削除し、APIのレスポンスで成功が通知されます。

## 6. 実装例
以下にNode.jsを使用した簡単な実装例を示します。`axios`ライブラリを使用してHTTPリクエストを行います。

![img](/mosaic-code.jpg)

## 7. まとめ
Notion APIを利用すると、プログラムでページ内容を制御し、コンテンツを簡単に管理することが可能です。APIを使用することで、定型操作を自動化し、Notionの利用体験を向上させることができます。

このガイドがNotion API操作の参考になり、実際のアプリケーション開発に役立つことを願っています。 [cv:issue_marketplace_engineer]

# Notion APIでページ内のブロックを追加・更新・削除する方法

## 目次
1. はじめに
2. Notion APIの概要
3. ページにブロックを追加する方法
4. ブロックを更新する方法
5. ブロックを削除する方法
6. 実装例
7. まとめ

## 1. はじめに
Notionは多機能なノートアプリとして知られており、APIを通じてページ内のブロックを動的に管理することができます。本記事では、Notion APIを使用してページ内のブロックを追加、更新、削除する方法を詳しく解説します。

## 2. Notion APIの概要
Notion APIは、外部アプリケーションがNotionデータベースやページ内のコンテンツにアクセスし、操作を行えるように設計されています。APIを使用するには、Notion Developer PortalでAPIキーを取得し、各リクエストにヘッダーとして渡す必要があります。

### 必要な事前準備
- NotionのAPIキーの取得
- 操作対象のページやデータベースのIDを取得

## 3. ページにブロックを追加する方法
Notion APIを使ってブロックを追加する場合、`https://api.notion.com/v1/blocks/parent_id/children`エンドポイントにPOSTリクエストを送ります。リクエストボディには追加するブロックの詳細を含める必要があります。

```json
{
    "children": [
        {
            "object": "block",
            "type": "paragraph",
            "paragraph": {
                "text": [
                    {
                        "type": "text",
                        "text": {
                            "content": "追加するコンテンツ"
                        }
                    }
                ]
            }
        }
    ]
}
```

## 4. ブロックを更新する方法
ブロックを更新するには、`PATCH`リクエストを`https://api.notion.com/v1/blocks/block_id`に送信します。更新するフィールドと新しいデータをリクエストボディに指定します。

```json
{
    "paragraph": {
        "text": [
            {
                "type": "text",
                "text": {
                    "content": "更新されたコンテンツ"
                }
            }
        ]
    }
}
```

## 5. ブロックを削除する方法
ブロックを削除する場合、`DELETE`リクエストを`https://api.notion.com/v1/blocks/block_id`に送信します。この操作は指定されたブロックを削除し、APIのレスポンスで成功が通知されます。

## 6. 実装例
以下にNode.jsを使用した簡単な実装例を示します。`axios`ライブラリを使用してHTTPリクエストを行います。

```javascript
const axios = require('axios');

const notionAPI = axios.create({
    baseURL: 'https://api.notion.com/v1',
    headers: {
        'Authorization': `Bearer YOUR_INTEGRATION_TOKEN`,
        'Content-Type': 'application/json',
        'Notion-Version': '2022-06-28'
    }
});

// ブロックを追加
async function addBlock(parentId, content) {
    try {
        const response = await notionAPI.post(`/blocks/${parentId}/children`, {
            children: [{
                object: 'block',
                type: 'paragraph',
                paragraph: {
                    text: [{
                        type: 'text',
                        text: { content }
                    }]
                }
            }]
        });
        console.log('Block added:', response.data);
    } catch (error) {
        console.error('Error adding block:', error);
    }
}

// ブロックを更新
async function updateBlock(blockId, newContent) {
    try {
        const response = await notionAPI.patch(`/blocks/${blockId}`, {
            paragraph: {
                text: [{
                    type: 'text',
                    text: { content: newContent }
                }]
            }
        });
        console.log('Block updated:', response.data);
    } catch (error) {
        console.error('Error updating block:', error);
    }
}

// ブロックを削除
async function deleteBlock(blockId) {
    try {
        await notionAPI.delete(`/blocks/${blockId}`);
        console.log('Block deleted');
    } catch (error) {
        console.error('Error deleting block:', error);
    }
}
```

## 7. まとめ
Notion APIを利用すると、プログラムでページ内容を制御し、コンテンツを簡単に管理することが可能です。APIを使用することで、定型操作を自動化し、Notionの利用体験を向上させることができます。

このガイドがNotion API操作の参考になり、実際のアプリケーション開発に役立つことを願っています。 

Notion APIでページ内のブロックを追加・更新・削除する方法

目次

1. はじめに

続きを読むには単価診断を受けてください（30秒）