GASでNotion APIを使う方法【無料で自動化】

最終更新日 2024-10-12 公開日 2023-09-22

この記事では、GAS（Google Apps Script）でNotion APIを使う方法について解説します。

Notion APIの概要や具体的な活用例、Notion APIを活用したサービスなどを知りたい場合は以下の記事を参考にしてください。

GAS（Google Apps Script）の使い方
GAS（Google Apps Script）とは
Google Apps Scriptエディタの開き方
GASで「こんにちは」と表示
GASのスクリプトプロパティにインテグレーションキーを登録
GASでデータベースにページを作成
GASでデータベースのページを更新
GASでデータベースからページを検索（取得）
GASで取得したNotionのデータをスプレッドシートに入力
Notionに蓄積されたデータを1日に1回スプシに吐き出し
Notion APIの公式ページ
おわりに

GAS（Google Apps Script）の使い方

まずは基本的なGAS（Google Apps Script）の使い方から解説します。GASの使い方についてすでに知っているという方はこのセクションを飛ばしてください。

GAS（Google Apps Script）とは、Googleが提供しているプログラミング言語で、Googleアカウントとブラウザ（インターネット環境）があれば無料で利用可能です。GAS（ガス）と呼ばれています。GmailやGoogleカレンダーなど、Google関連のサービスを連携、自動化させることができる上にWeb APIを活用すればNotionなど、Google以外のサービスとも連携が可能です。

Google Apps Scriptエディタの開き方

まずは、スプレッドシート（スプシ）を開きます。Googleドライブ、もしくは、sheets.google.com でスプレッドシートのホーム画面を開き、新規アイコン「+」をクリックすると、新しいスプレッドシートが作成されて開きます。

「拡張機能」→「Apps Script」をクリックします。

Google Apps Scriptエディタを開くことができます。

GASで「こんにちは」と表示

まずは以下のような関数をエディタ部分に入力します。

function myFunction() {
  console.log("こんにちは");
}

「実行」をクリックします。
実行ログに「こんにちは」と表示されます。

GASで「こんにちは」と表示

{{CURRENT_MONTH}}月限定のお得なご案内

もっと Notion を学びたい方へ

Notion大学の会費が初月半額(年間払いの場合は9,000円オフ)となるお得なクーポンを期間限定で発行中。 Notion大学は、2025年{{CURRENT_MONTH}}月時点で会員数は500名以上のオンラインコミュニティです。

分からないことは24時間チャットツールでいつでも質問可能
月に20回以上開催される限定勉強会で最新情報が学べる
1日15分から学べる Notion 学習ロードマップで初心者からでも学習可能
Notion 大学限定の学習動画が100本以上
過去の有料記事・有料テンプレートが全て閲覧可能

お得なこの機会に、ぜひ入学をご検討ください。

50%OFFクーポンを使って入会する → Notion大学について詳しく知る↗︎

GASのスクリプトプロパティにインテグレーションキーを登録

Notion APIで使用するインテグレーションキーをGASのスクリプトプロパティに登録します。スクリプトプロパティは、インテグレーションキーのように流出してはいけないものを保存しておける場所です。コード内にインテグレーションキーを書くこともできますが、意図せずコードを公開してしまった時にインテグレーションキーも見られてしまうので危険です。スクリプトプロパティにインテグレーションキーを登録しておけば、コードを公開してもインテグレーションキーが見られることはないので安全です。

スクリプトプロパティは左のメニューの「⚙️」から設定することができます。

「プロパティ」：任意のキー名（今回はNOTION_API_KEY）
「値」：インテグレーションキー（secret_*****）

もし、インテグレーションキーをまだ取得していない場合は、以下の記事を参考にしてください。

Notion APIとは？できることや使い方を初心者向けに解説 - Notionラボ

設定したスクリプトプロパティは以下のコードで取得することができます。

const key = PropertiesService.getScriptProperties().getProperty('NOTION_API_KEY');

円谷

インテグレーションキーのみではなく、データベースIDなども登録しておくことができます。

GASでデータベースにページを作成

Notion API接続用のデータベースを準備します。今回はテスト用に以下のようなデータベースを作成しました。

名前：タイトルプロパティ
タグ：マルチセレクトプロパティ

テスト用DB

上記のデータベースに以下のページを追加します。

名前：「GASで追加」
タグ：「GAS」

まずはデータベースのIDを取得します。テスト用のデータベースのURLは以下です。

https://www.notion.so/chabesu-blog/22e5dc3676004661a16a6c45e5ee1a4c?v=1cc5044e126b415899a940fb284cab66

上記のURLの22e5dc3676004661a16a6c45e5ee1a4cがデータベースIDです。

データベースにページを追加するコードは以下のように書きます。

function createPage() {
  const NOTION_API_KEY = PropertiesService.getScriptProperties().getProperty('NOTION_API_KEY');
  const database_id = '22e5dc3676004661a16a6c45e5ee1a4c';

  const url = 'https://api.notion.com/v1/pages';

  const payload = {
    'parent': { 'database_id': database_id },
    'properties': {
      '名前': {
        'title': [
          {
            'text': {
              'content': 'GASで追加'
            }
          }
        ]
      },
      'タグ': {
        'multi_select': [
          {
          'name': 'GAS'
          
          }
        ]
      }
    }
  };

  const opts = {
    'method': 'POST',
    'headers': {
      'Notion-Version': '2022-06-28',
      'Authorization': 'Bearer ' + NOTION_API_KEY,
      'Content-Type': 'application/json'
    },
    'payload': JSON.stringify(payload),
  };

  UrlFetchApp.fetch(url, opts);
}

関数名はcreatePageに変更したので、実行する関数をcreatePageに変更し、「実行」をクリックします。実行ログにエラーが出ず、「実行完了」と表示されればOKです。

ただし、実行初回は以下のような表示が出ます。まずは「権限を確認」をクリックします。

続いて、「詳細」をクリックします。

「Notion APIテスト（安全ではないページ）に移動」をクリックします。「Notion APIテスト」の部分はファイル名なので、人によって変わります。

関数を実行し、成功していればデータベースに「GASで追加」が追加されています。

GASでデータベースのページを更新

上記のデータベースの「GASで追加」ページの「GAS」タグを「タグ2」に変更します。

まずは、「GASで追加」ページのURLを確認して、ページIDを取得します。

https://www.notion.so/chabesu-blog/GAS-00e45997dc8f4537a232efe2760b148c

上記のURLの00e45997dc8f4537a232efe2760b148cの部分がページIDです。

ページIDを取得したら、ページを更新するコードを書きます。先ほどのページ作成のコードとの違いとして以下のような点に注意してください。

methodがPOST → PATCHに変更
database_idをpage_idに変更
urlを変更

function updatePage() {
  const NOTION_API_KEY = PropertiesService.getScriptProperties().getProperty('NOTION_API_KEY');
  const page_id = '00e45997dc8f4537a232efe2760b148c';

  const url = 'https://api.notion.com/v1/pages/' + page_id;

  const payload = {
    'properties': {
      'タグ': {
        'multi_select': [
          {
          'name': 'タグ2'
          }
        ]
      }
    }
  };

  const opts = {
    'method': 'PATCH',
    'headers': {
      'Notion-Version': '2022-06-28',
      'Authorization': 'Bearer ' + NOTION_API_KEY,
      'Content-Type': 'application/json'
    },
    'payload': JSON.stringify(payload),
  };

  UrlFetchApp.fetch(url, opts);
}

関数名はupdatePageに変更したので、実行する関数をupdatePageに変更し、「実行」をクリックします。実行ログにエラーが出ず、「実行完了」と表示されればOKです。

関数を実行し、成功していればタグが「タグ2」に変更されています。

GASでデータベースからページを検索（取得）

データベースから以下の条件に該当するページを取得します。

「タグ」プロパティが「タグ2」に等しい

ページを検索するコードを記載します。以下に注意してください。

database_idを使用
methodがPOST
urlにはqueryを使用

function queryPage() {
  const NOTION_API_KEY = PropertiesService.getScriptProperties().getProperty('NOTION_API_KEY');
  const database_id = '22e5dc3676004661a16a6c45e5ee1a4c';

  const url = 'https://api.notion.com/v1/databases/' + database_id + '/query';

  const payload = {
    'filter': {
      'property': 'タグ',
      'multi_select': {
        'contains': 'タグ2'
      }
    }
  };

  const opts = {
    'method': 'POST',
    'headers': {
      'Notion-Version': '2022-06-28',
      'Authorization': 'Bearer ' + NOTION_API_KEY,
      'Content-Type': 'application/json'
    },
    'payload': JSON.stringify(payload),
  };

    let result = JSON.parse(UrlFetchApp.fetch(url, opts));
  // 取得したページのプロパティの情報を表示
  console.log(result.results[0].properties);
}

関数名はqueryPageに変更したので、実行する関数をqueryPageに変更し、「実行」をクリックします。実行ログにエラーが出ず、ページの情報が表示されれば成功です。

{ 'タグ': { id: 'iZgD', type: 'multi_select', multi_select: [ [Object] ] },
  '名前': { id: 'title', type: 'title', title: [ [Object] ] } }

ただし実行結果がわかりづらいので、コードの最後の部分を以下のように変更します。

// 取得したページのプロパティの情報を表示
console.log(result.results[0].properties['名前']);

再び実行すると以下のような出力となり、「GASで追加」のページが取得できていることがわかります。

{ id: 'title',
  type: 'title',
  title: 
   [ { type: 'text',
       text: [Object],
       annotations: [Object],
       plain_text: 'GASで追加',
       href: null } ] }

円谷

フィルタ条件の指定方法はプロパティ毎に違います。詳細は、下記の公式ページを参照して下さい。

Filter database entries

GASで取得したNotionのデータをスプレッドシートに入力

データベースから以下の条件に該当するページを取得し、スプレッドシートのA1 セルに「名前」プロパティ、B1 セルに「タグ」プロパティを書き込みます。

「タグ」プロパティが「タグ2」に等しい

事前にスプレッドシートのIDを取得しておきます。スプレッドシートのIDはスプレッドシートのURLのうちの一部です。

今回のスプレッドシートのURLは以下です。

https://docs.google.com/spreadsheets/d/1ZXbGHy7-mKEqQK0bOQLX7W77EVgJxAQHxcM4mHDcRGI/edit#gid=0

上記のURLのうち、1ZXbGHy7-mKEqQK0bOQLX7W77EVgJxAQHxcM4mHDcRGIの部分がスプレッドシートのIDです。

また、今回のスプレッドシートのシート名は「シート1」です。

ページを検索（取得） → スプレッドシートに書き込むコードは以下です。

function main() {
  // スプレッドシートのID
  const sheet_id = "1ZXbGHy7-mKEqQK0bOQLX7W77EVgJxAQHxcM4mHDcRGI"
  // スプレッドシートのシート名
  const sheet_name = "シート1"

  const NOTION_API_KEY = PropertiesService.getScriptProperties().getProperty('NOTION_API_KEY');
  const database_id = '22e5dc3676004661a16a6c45e5ee1a4c';

  const url = 'https://api.notion.com/v1/databases/' + database_id + '/query';

  const payload = {
    'filter': {
      'property': 'タグ',
      'multi_select': {
        'contains': 'タグ2'
      }
    }
  };

  const opts = {
    'method': 'POST',
    'headers': {
      'Notion-Version': '2022-06-28',
      'Authorization': 'Bearer ' + NOTION_API_KEY,
      'Content-Type': 'application/json'
    },
    'payload': JSON.stringify(payload),
  };

  let result = JSON.parse(UrlFetchApp.fetch(url, opts));
  let page_name = result.results[0].properties["名前"].title[0].plain_text;
  let tag_name = result.results[0].properties["タグ"].multi_select[0].name;

  //スプレッドシートのシートのクラスを取得
  const sheet = SpreadsheetApp.openById(sheet_id).getSheetByName(sheet_name);

  sheet.getRange("A1").setValue(page_name);
  sheet.getRange("B1").setValue(tag_name);
}

成功すると、以下のようにスプレッドシートのA1 セルに「名前」プロパティ、B1 セルに「タグ」プロパティが書き込まれます。

Notionに蓄積されたデータを1日に1回スプシに吐き出し

以下の記事では、

Notion側に蓄積されたデータをGAS（Google Apps Script）を使って1日に1回Googleシートに吐き出し
Notion側で付けたタグごとにGoogleシート内で集計
Googleシート内でグラフとして可視化
ということをGASで行っています（GASを使うのは 1. のみ）。GASを使った実践的なNotion APIの使い方が載っているので、ぜひ参考にしてみてください。

Notion APIの公式ページ

Notion APIについてさらに詳しく知りたい方は、Notion APIの公式ページを参照してください。

例えば、今回解説した内容は公式では以下のリンクに掲載されています。

データベースにページを作成：Create a page
データベースのページを更新：Update a database
データベースからページを検索（取得）：Query a database

おわりに

今回は、GASを使用してNotion APIを使用する方法を紹介しました。JavaScriptやPythonでNotion APIを使用する方法については以下の記事を参考にしてください。

参考：Notion APIを使ってみた話 | Sqripts

この記事の執筆者

チャベス

Webライター・ディレクター。Notion公式のおすすめのテンプレートクリエイター。個人でNotionをちょっと便利にするChrome拡張機能を開発中。代表作は「NotionSidebarHider」「Notion文字数カウント」。本業はメーカーで研究開発をしているエンジニア。

Twitter / Notion

個人利用

Notion API

Notionの教科書	料金プランの教科書
Notion AIの教科書	Notionメールの教科書
Notionカレンダーの教科書	Notionデータベースの教科書

データベース基礎を学ぶ

テーブルビュー	リストビュー
ギャラリービュー	ボードビュー
カレンダービュー	タイムラインビュー
チャート

個人向けの活用事例を知る

GTD/タスク管理	議事録管理
読書記録	習慣管理
日記	家計簿

Notionに関するご相談

構築代行/コンサルティング	プロジェクト管理
CRMツール制作

法人向け

個人向け