S15. 更新 (Update)

15.1 データベースプロパティ等を更新 (Update database)

• データベースプロパティ等を更新する API の説明はこちらです。
Start building with the Notion API
Updates page property values for the specified page. Properties that are not set via the properties parameter will remain unchanged. If the parent is a database, the new property values in the properties parameter must conform to the parent database's property schema. Archive (delete) a page Set the...

https://developers.notion.com/reference/patch-page

• このデータベースの URL を取得してここに貼り付けてください。
📝

ページURL

例: https://www.notion.so/hkob/125d1bce9cb341b3acb19ba4b6599e37?v=39ccfafab6524a70b72276df953b35e5

https://api.notion.com/v1/databases/{database_id}

15.1.1 プロパティ設定の更新

• 数値プロパティの数値の書式を変更する Property schema object を BODY に記述します。

設定画面は以下のようになります。

15.1.2 プロパティ名の変更

• 数値プロパティの名前を金額に変更する Property schema object を BODY に記述します。

{
  "properties": {
    "数値": {
      "name": "金額"
    }
  }
}

15.1.3 新規プロパティの追加

• 新規プロパティを追加する Property schema object を BODY に記述します。既存のプロパティ名と異なる場合には、プロパティは追加されます。

{
  "properties": {
    "時刻": {
      "formula": {
        "expression": "now()"
      }
    }
  }
}

15.1.4 プロパティ種別の変更

• プロパティ種別の変更を行う Property schema object を BODY に追加します。既存のプロパティ名と同じものを設定した場合には、プロパティ種別の変更になります。

{
  "properties": {
    "時刻": {
      "date": {
      }
    }
  }
}

15.1.5 プロパティの削除

• プロパティ名キー値を null にすることで、プロパティを削除することができます。

{
  "properties": {
    "時刻": null
  }
}

15.2 ページプロパティ等を更新 (Update page)

• ページプロパティ等を更新する API の説明はこちらです。
Start building with the Notion API
Updates page property values for the specified page. Properties that are not set via the properties parameter will remain unchanged. If the parent is a database, the new property values in the properties parameter must conform to the parent database's property schema. Archive (delete) a page Set the...

https://developers.notion.com/reference/patch-page

15.2.1 単体ページの更新

• このページの URL を取得してここに貼り付けてください。
📝

ページURL

例: https://www.notion.so/hkob/a93634dfea494e00a6979ca4ff25038e

• page_id は末尾の 32 桁の 16 進数です。下の赤字の部分にこの page_id を記述してください。ヘッダ部分はこれまでの のものと変更はありません。

https://api.notion.com/v1/pages/ここに上のpage_idを記述

• メソッドを PATCH に変更します。

• BODY にアイコンのための Emoji object とタイトルの変更のための Property value object を記述します。

{
  "icon": {
    "type" : "emoji",
    "emoji": "3️⃣"
  },
  "properties": {
    "title": {
      "title": [
        {
          "type": "text",
          "text": {
            "content": "変更後のタイトル"
          }
        }
      ]
    }
  }
}

• 画面は以下のようになります。実行すると上の更新テスト用ページが変更されるはずです。

15.2.2 データベースページの更新

• 上で作成したデータベース内の片方のページのリンクを上に置きました。このページの URL を取得してここに貼り付けてください。
📝

ページURL

例:

https://www.notion.so/hkob/1-6698892a00b448819cf1fe2fa2fd2ce4

• page_id は末尾の 32 桁の 16 進数です。下の赤字の部分にこの page_id を記述してください。ヘッダ部分はこれまでのものと変更はありません。

https://api.notion.com/v1/blocks/ここに上のpage_idを記述

• このページの金額を変更する BODY は以下のようになります。

{
  "properties": {
    "金額": {
      "number": 2980
    }
  }
}

15.3 ブロックを更新 (Update a block)

• ブロックの例として、上に To Do ブロックを置きました。このブロックの URL を取得してここに貼り付けてください。
📝

ブロックURL

例:

https://www.notion.so/hkob/T15-Update-7fce048765134ec887699e607de48735#a6e8733688ac408d93741b0462f11b2a

• block_id は末尾の # の後ろの 32 桁の 16 進数です。下の赤字の部分にこの block_id を記述してください。ヘッダ部分はこれまでの のものと変更はありません。

https://api.notion.com/v1/blocks/ここに上のblock_idを記述

• To Do ブロックのチェックを入れる BODY は以下のようになります。

{
  "to_do": {
    "checked": true
  }
}