ChatGPT は、私たちの生活と仕事のスタイルをひっくり返すため、最近非常に瞬きしています。同様に、私は OpenAI API GPT3 および GPT 3.5 API を使用する傾向にあります。これは、私の生活を完全に自動化し、時間の無駄だが重要な反復作業の負荷を軽減できるからです。両方を使用すると、バターと霜降りの豊かな和牛を食べるのと同じです。

実際、選択肢は 1 つだけということはありません。 API と AI チャットボットの間で、Anthropic の Claude 生成 AI モデルを使用しているNotion AI は、AI ライティングと API 機能を備えた半自動 AI エクスペリエンスを完璧に提供できます。 GPT 3ほどのクランチ感はありませんが、クリアで薄くストレートな使用感をユーザーに印象付けます。

この記事では、Notion プライベート ページから Notion AI コンテンツを取得し、Notion API を使用して新しいコンテンツを更新する方法について説明します。

目次: Notion API を使用した CRUD Notion ページ コンテンツ

• アプリと Notion API キーの作成
• 基本認証とヘッダー設定
• 新しい概念ページを作成する
• Notion ページのコンテンツを取得する
• Notion ページ ブロックのコンテンツを更新する
• 概念ページの削除
• Notion API を使用した取得と更新の完全な Python スクリプト
• よくある質問

新しいアプリと Notion API キーの作成

Notion では、生成 AI の 20 リクエストの無料トライアルを提供しています。 OpenAI などの他の AI プラットフォームと比較して、Notion の強みはオンサイトのコンテンツとデータベースの管理であり、主にライティング、翻訳、要約に関連します。月額プランがあり、価格は10ドルです。無料プランでも月額プランでも、ユーザーはアプリを作成できるため、アプリを Notion に接続できます。しかし、私の観点からすると、Notion AI を使用せずに API を使用するだけであれば、参加する価値はありません。それは、データベースとコンテンツ ハブの管理上にあるため、利用可能なオプションが非常に多く、率直に言って開発者にとって非常に便利だからです。

API キーは接続管理ページで入手できます。API に設定できるオプションは 2 つあり、内部とパブリックです。この場合、内部目的を選択できます。

作成したら、事前に新しい親ページを作成し、アプリとページを接続してください。基本的には準備ができたので、スクリプトの作成を開始できます。

Python の基本的な API 認証とヘッダー設定

基本的に、CRUD ページ コンテンツで使用する主な Notion API エンドポイントは 2 つあります。これらは次のとおりです。

https://api.notion.com/v1/pages

https://api.notion.com/v1/block. s/

次に、アプリの状況に応じてクラスを作成するかどうかでヘッダーを設定する必要があります。どのような場合でも、これは設定する必要がある基本的なヘッダーです。

 headers = {
 "accept" :"application/json" ,
 "Notion-Version" :"2022-06-28" ,
 "content-type" :"application/json" ,
 "Authorization" :"your Notion API Key"
 }

CRUD – Notion API を使用して Notion ページを作成する

既存のページの子である新しいページを作成するには、タイトル コンポーネントのみが必要です。タイトルは、プロパティ本体パラメータ内の唯一の有効なプロパティです。

新しいページを作成する完全なスクリプトに興味がある場合は、「第 75 章 + 概念 API」というメッセージを残して購読してください。

CRUD – Notion API を使用して Notion プライベート ページ ブロック コンテンツを取得する

ページ ブロックのコンテンツを取得するには、親ページ ID と json ライブラリという 2 つの主要コンポーネントが必要です。

まず最初に、検索エンドポイントを使用してページ ID を取得するか、ID を直接コピーしてこのエンドポイント パスに入力します。

url = "https://api.notion.com/v1/blocks/" + pageID + "/children"

次に、リクエストを使用してエンドポイント データを呼び出すと、JSON データ形式が返されるため、それを解釈するために json() を追加する必要があります。

response = requests . get ( url , headers = headers ). json ()['results']

最後になりましたが、応答の形式は次のようになります。少し長く見えますが、複雑ではありません。

{
"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-07-06T19:41: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": "green"
},
"plain_text": "Lacinato kale",
"href": null
}
],
"color": "default",
"is_toggleable": false
}
}

CRUD – Notion API を使用して Notion プライベート ページ ブロック コンテンツを更新する

Notion ページのコンテンツの取得と同様に、更新にも同じ API エンドポイント パスが使用されます。ここでは、「get」メソッドを使用する代わりに、特定のページ ブロックのコンテンツを更新するために patch メソッドが必要です。

 response = requests . request (
 "PATCH" ,
 url ,
 headers = headers ,
 json ={"children" : [text_block ]}
 )

特定のコンテンツ タイプと形式に従って、キーの子を含む JSON データも必要です。以下にサンプルを示します。

 text_block = {
 "type" :"paragraph" ,
 "paragraph" :{
 "rich_text" :[{
 "type" :"text" ,
 "text" :{
 "content" :textBook ,
 "link" :None
 }
 }]
 }
 }

CRUD – 削除の概念

Notion では、Notion ページを削除することをアーカイブと呼びます。 API 経由でページをアーカイブするには、アーカイブされた本文パラメータをtrueに設定してページ更新リクエストを送信します。ページを復元するには、 archived をfalseに設定します。

新しいページを作成する完全なスクリプトに興味がある場合は、「第 75 章 + 概念 API」というメッセージを残して購読してください。

Notion API を使用した取得と更新の完全な Python スクリプト

第 75 章 – Notion API と Python を使用した CRUD Notion ページ コンテンツに興味がある場合は、 「第 75 章 + 概念 API」というメッセージを追加してニュースレターを購読してください。 。スクリプトはすぐにあなたのメールボックスに送信されます。

第 75 章 – Notion API と Python を使用した CRUD Notion ページ コンテンツを楽しんで読んでいただければ幸いです。もしそうなら、以下にリストされているいずれかの方法で私たちをサポートしてください。それは常に私たちのチャンネルに役立ちます。

• PayPal ( paypal.me/Easy2digital ) を通じて私たちのチャンネルをサポートし、寄付してください。
• 私のチャンネルを購読し、 Easy2Digital Youtube チャンネルの通知ベルをオンにしてください。
• Easy2Digital Facebook ページをフォローして「いいね！」してください
• ハッシュタグ #easy2digital を付けて記事をソーシャル ネットワークで共有してください
• Easy2Digital の最新記事、ビデオ、割引コードを受け取るには、毎週のニュースレターに登録してください。
• Patreon を通じて月額メンバーシップに登録すると、限定特典をお楽しみいただけます ( www.patreon.com/louisludigital )