SQL見るだけクエリ#173 PHPとNotionのAPIで、Notion上の特定のデータベースの情報を取得

PHPとNotionのAPIで、Notion上の特定のデータベースの情報を取得する方法を解説してみようと思います。

この記事を読むと（約5分）
PHPとNotionのAPIで、Notion上の特定のデータベースの情報を取得する方法をイメージできます。

特定のデータベースの情報を取得

以下のコードは、PHPを使用してNotionのAPIを呼び出し、Notion上の特定のデータベースの情報を取得するためのものです。以下に、コードの内容と概念的な内容を解説します。

　概念的な説明:

cURLを使用して、HTTPリクエストを送信してAPIと通信します。cURLは、多くのプログラミング言語で利用可能なライブラリであり、HTTPリクエストを簡単に作成し送信できます。
NotionのAPIを使用するためには、APIキーまたは認証トークンが必要です。このコードでは、AuthorizationヘッダーにBearerトークンを含めることで認証を行っています。
NotionのAPIは、HTTPリクエストを送信して特定のエンドポイントにアクセスし、データベースの情報を取得します。エンドポイントは、APIのバージョン、データベースのIDなどを含むURLです。
レスポンスはJSON形式で受け取られます。このコードでは、json_decode() 関数を使用してJSONをPHPのオブジェクトに変換しています。
取得したデータを処理して表示するために、オブジェクトのプロパティにアクセスします。レコードの各プロパティには、名前、タグ、数値などの情報が含まれます。


$curl = curl_init();

$query_var = [
];
$query = json_encode($query_var);


curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.notion.com/v1/databases/XXXXXXXXXXX/query",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
        "Notion-Version: 2022-06-28",
        "accept: application/json",
        'Authorization: Bearer ' . 'secret_XXXXXXXXXXXXXXXXXXXXXXXXXXXX'
    ],
    CURLOPT_POSTFIELDS => $query
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    $response = json_decode($response);

    $results = $response->results;

    foreach ($results as $record) {
        echo "ページID: " . $record->id . "<br>";
        echo "作成日時: " . $record->created_time . "<br>";
        echo "最終編集日時: " . $record->last_edited_time . "<br>";
        echo "作成者: " . $record->created_by->id . "<br>";
        echo "最終編集者: " . $record->last_edited_by->id . "<br>";

        // 名前の情報を表示
        $nameProperty = $record->properties->名前->title[0]->plain_text;
        echo "名前: " . $nameProperty . "<br>";

        // タグの情報を表示
        $tags = $record->properties->タグ->multi_select;
        echo "タグ: ";
        foreach ($tags as $tag) {
            echo $tag->name . " ";
        }
        echo "<br>";

        // 数値の情報を表示
        $numberProperty = $record->properties->数値->number;
        echo "数値: " . $numberProperty . "<br>";

        echo "<br>";
    }
}

　コードの説明:

curl_init() 関数を使用して、cURLセッションを初期化します。
json_encode() 関数を使用して、空のクエリ変数をJSON形式に変換します。
curl_setopt_array() 関数を使用して、cURLオプションを設定します。これには、APIエンドポイントのURL、リクエストのタイムアウトやバージョン、HTTPヘッダー、認証トークンなどが含まれます。
curl_exec() 関数を使用して、cURLリクエストを実行し、APIからのレスポンスを取得します。
curl_error() 関数を使用して、エラーメッセージを取得します。
cURLセッションを終了し、リソースを解放します。
エラーチェックを行い、エラーがあれば表示します。
レスポンスをJSON形式からデコードし、結果を処理します。各レコードに対して、ページID、作成日時、最終編集日時、作成者、最終編集者などの情報を表示します。

このコードを使用すると、Notionの特定のデータベースから取得した情報を処理し、表示することができます。具体的な情報の表示方法は以下の通りです:

ページID ($record->id): レコードの一意の識別子であり、各ページに割り当てられています。
作成日時 ($record->created_time): レコードが作成された日時です。
最終編集日時 ($record->last_edited_time): レコードが最後に編集された日時です。
作成者 ($record->created_by->id): レコードを作成したユーザーの識別子です。
最終編集者 ($record->last_edited_by->id): レコードを最後に編集したユーザーの識別子です。
名前 ($record->properties->名前->title[0]->plain_text): レコードの「名前」というプロパティの値を表示します。このコードでは、プロパティがタイトル型であることを想定しています。
タグ ($record->properties->タグ->multi_select): レコードの「タグ」というプロパティの値を表示します。このコードでは、プロパティが複数選択型であることを想定しています。タグは複数存在する可能性があるため、foreach ループを使用して各タグを表示します。
数値 ($record->properties->数値->number): レコードの「数値」というプロパティの値を表示します。

上記のコードは、NotionのAPIを使用して特定のデータベースの情報を取得し、取得した情報を処理して表示する一般的な手法を示しています。このコードを適切に使用するには、以下の点に注意する必要があります:

XXXXXXXXXXX と 'secret_XXXXXXXXXXXXXXXXXXXXXXXXXXXX' の部分は、実際のデータベースのIDと認証トークンに置き換える必要があります。これらの値は、Notionの開発者向けドキュメントから取得することができます。
コード内の各プロパティ名 (名前、タグ、数値など) は、実際のデータベースのプロパティ名に合わせて変更する必要があります。

このコードを使用すると、NotionのデータベースをPHPで効果的に操作し、取得した情報を必要な形式で表示することができます。