PythonからGASのWebアプリにデータを送ってスプレッドシートに追記する|doPostの作り方

Pythonで集めたデータや処理結果を、スプレッドシートにも残しておきたい。でも、Google の API を使う準備(サービスアカウントや認証の設定)は、ちょっと腰が重いですよね。

そんなときに手軽なのが、GAS を「データの受け口(Webアプリ)」として公開して、Python から送り込む方法です。GAS側に doPost という関数を1つ書くだけで、Pythonから送ったJSONがスプレッドシートに1行ずつ追記されるようになります。細かい記録をスプレッドシートに貯めたいときに便利な形です。

💡
この記事で解決すること

GASでJSONを受け取ってシートに追記する doPost を作り、ウェブアプリとしてデプロイします。Python の requests からPOSTして、1行追記されるところまでつなげます。
URLを知っていれば誰でも送れてしまうので、合言葉(トークン)のチェックを入れ、URLと合言葉は環境変数とスクリプトプロパティで管理します。


この記事の前提

  • GASのスクリプトエディタで関数を実行したことがある。GASから外部にアクセスする基本は GASでWeb APIを呼ぶ|UrlFetchAppとJSONの基本 で解説しています
  • Pythonの requests を使ったことがある。まだの方は PythonでWeb APIのJSONを取得してCSVに保存する|requests入門 からどうぞ
  • この記事のコードは、次の2つで動作を確認しています。GASのコードは、GASの機能をまねた Node.js 上のテストで分岐(成功・合言葉違い・項目不足・JSONでない・シートがない)を確認。Pythonのコードは、GASと同じように「POSTを受けたら別のURLへ転送(リダイレクト)して結果を返す」練習用のローカルサーバーに送って確認しました(Debian GNU/Linux 13、Python 3.13.5、requests 2.34.2)。実際のGoogleへのデプロイ画面と実シートの実行結果は載せていません(掲載しているターミナル画像はローカル/Node.js のモックです)

用語メモ
用語 ざっくりした意味
ウェブアプリ(Web App) GASのスクリプトを、URLでアクセスできる形で公開したもの
doPost ウェブアプリのURLにPOST(データを送る)リクエストが来たときに、GASが自動で呼ぶ関数
デプロイ 書いたスクリプトを「この版で公開する」と確定させる操作
リダイレクト 「本当の返事は別のURLにあるよ」と案内されて、そちらへ移動すること
トークン(合言葉) 送ってきた相手が本人かどうかを確かめるための、長いランダムな文字列
LockService 同時に2つのリクエストが来ても、1つずつ順番に処理させるためのGASの機能

結論:doPost で受け取り、合言葉が合うときだけ追記する

全体の流れはこうなります。

  1. GAS に doPost(e) を書き、e.postData.contents(送られてきた本文)をJSONとして読む
  2. 合言葉が合っていて、必要な項目がそろっているときだけ、シートに1行追記する
  3. 結果は {"ok": true} のようなJSONで返す
  4. Python は requests.post で送り、返ってきたJSONの ok を確認する

PythonからGASウェブアプリにPOSTし、302のあとGETで結果を受け取る流れ

手順1:受け取り用のシートを用意する

スプレッドシートに「受信ログ」という名前のシートを作り、1行目に見出しを入れておきます(A列:日時、B列:name、C列:value)。2行目以降に、送られてきたデータが追記されていきます。


手順2:合言葉をスクリプトプロパティに保存する

合言葉は、推測されにくい長いランダムな文字列にします。Python が入っていれば、ターミナルで次を実行すると作れます。

  • 1
python3 -c "import secrets; print(secrets.token_urlsafe(32))"

表示された文字列を、GASの Project Settings(歯車のアイコン)→ Script Properties の「Add script property」で、Property を WEBAPP_TOKEN にして Value に保存し、「Save script properties」を押します(表記は公式ガイド Properties Service の英語に合わせています)。この文字列はあとでPython側でも使うので、パスワード管理ツールなどに控えておきましょう。


手順3:doPost のコードを貼る

スプレッドシートの「拡張機能」→「Apps Script」を開き、次のコードを貼り付けて保存します。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
// Python などから POST された JSON を「受信ログ」シートに1行追記するウェブアプリ
const MAX_BODY = 10000; // 受け付ける本文の上限(文字数の目安)

function doPost(e) {
  try {
    if (!e || !e.postData || e.postData.contents.length > MAX_BODY) {
      return json_({ ok: false, error: 'bad request' });
    }
    const data = JSON.parse(e.postData.contents);
    if (data === null || typeof data !== 'object' || Array.isArray(data)) {
      return json_({ ok: false, error: 'bad request' });
    }

    // 合言葉(トークン)が一致しないリクエストは書き込まない
    const token = PropertiesService.getScriptProperties().getProperty('WEBAPP_TOKEN');
    if (!token || data.token !== token) {
      return json_({ ok: false, error: 'unauthorized' });
    }

    const name = checkName_(data.name);
    if (name === null) {
      return json_({ ok: false, error: 'name の形式が正しくありません' });
    }
    const value = data.value;
    if (typeof value !== 'number' || !Number.isFinite(value) || Math.abs(value) > 1e9) {
      return json_({ ok: false, error: 'value は数値(±10億以内)にしてください' });
    }

    const lock = LockService.getScriptLock();
    lock.waitLock(10000); // 同時に届いても1件ずつ書く(最大10秒待つ)
    try {
      const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('受信ログ');
      if (!sheet) throw new Error('シート「受信ログ」が見つかりません');
      sheet.appendRow([new Date(), name, value]);
    } finally {
      lock.releaseLock();
    }
    return json_({ ok: true });
  } catch (err) {
    // 例外の本文やスタックには受け取った値が入ることがあるので、ログには種類だけを残す
    console.error(err instanceof SyntaxError ? 'JSON parse error' : 'doPost error: ' + (err && err.name ? err.name : 'Error'));
    return json_({ ok: false, error: 'server error' });
  }
}

// name を確かめる。問題なければ前後の空白を除いた文字列、だめなら null を返す
function checkName_(raw) {
  if (typeof raw !== 'string') return null;
  const name = raw.trim();                                   // 前後の空白・タブ・改行を除く
  const len = Array.from(name).length;                       // コードポイント単位で数える
  if (len === 0 || len > 100) return null;
  if (/[�--Ÿ]/.test(name)) return null; // 途中の改行・タブなどの制御文字
  if (/^[=+\-@=+-@]/.test(name)) return null;              // 先頭が数式の記号(全角も)
  return name;
}

function json_(obj) {
  return ContentService.createTextOutput(JSON.stringify(obj))
    .setMimeType(ContentService.MimeType.JSON);
}

コードのポイントです。

  • e.postData.contents に、送られてきた本文(文字列)が入っています。公式ドキュメントのウェブアプリの説明に、イベントオブジェクトの中身の一覧があります
  • 合言葉が違うときは、シートに書かずに ok: false を返します
  • 本文が大きすぎるとき(この例では1万文字超)や、JSONがオブジェクトでないときは、読まずに bad request を返します
  • name は checkName_ で確かめます。前後の空白・タブ・改行を取り除いてから、長さ(コードポイント単位で1〜100。多くの絵文字は1と数えますが、組み合わせた絵文字は2以上になることがあります)、途中の改行・タブなどの制御文字、先頭の =・+・-・@(全角の =+-@ も)を調べ、だめなら書き込みません。そのため「-5」のようにマイナスで始まる名前も受け付けません
  • 先頭の記号を見る理由は2つあります。1つは、公式リファレンスに「= で始まる内容は数式として解釈される」と書かれていることです。もう1つは、シートをCSVで書き出して Excel などで開くときに、+・-・@ やタブ・改行で始まる値も数式として扱われることがある(CSVインジェクション)ためです。+・-・@ や全角の =+-@、空白のあとの = が、Googleスプレッドシートで数式として実行されると公式に書かれているわけではなく、この記事でも実際のシートでは確かめていません。これらは「念のため拒否しておく」保守的な対策です
  • このチェックは、すべての危ない入力を防ぐ保証ではありません。記号の拒否リストでは、思いつかなかったパターンは通ってしまいます。ゼロ幅スペースのように見た目では分からない文字が先頭に付くと、今の trim と先頭記号の検査をすり抜けることがあります。また、実際のスプレッドシートが数式として解釈するかどうかは、この記事では確かめていません。使い道が決まっているなら、使える文字を決めておく(例:英数字と日本語だけ)許可リストのほうが守りが固くなりますが、その範囲は自分の用途に合わせて決める必要があります
  • エラーのメッセージやスタックには、送られてきた本文の一部(合言葉を含むことがある)が入ることがあります。そのためログには、JSONの読み取りエラーなら「JSON parse error」、それ以外は「doPost error: 」とエラーの種類だけを残します
  • LockService.getScriptLock() で、同時に届いたリクエストを1件ずつ処理します。waitLock(10000) は「最大10秒、順番を待つ」という意味です
  • 返事は ContentService でJSONにして返します。この例では、成功・失敗をJSONの ok で伝えます
  • 返事には server error とだけ返します。外の相手に、中の事情を細かく見せないためです。ログが種類だけなので、原因を調べるときは練習用のシートで再現して確かめます

GASの機能をまねたテスト(Node.js 上のモック。実際のGASやスプレッドシートではありません)で確かめた結果はこうでした。テスト呼び出しは27ケースで、失敗は0件でした。

送った内容 返事 シートへの追記
正しい合言葉、name と value あり {"ok":true} 1行追記
合言葉が違う {"ok":false,"error":"unauthorized"} なし
value がない {"ok":false,"error":"value は数値(±10億以内)にしてください"} なし
name が = で始まる、空白やタブ・改行のあとに = が続く、全角の = で始まる {"ok":false,"error":"name の形式が正しくありません"} なし
name が空白だけ、途中に改行がある、101文字以上 {"ok":false,"error":"name の形式が正しくありません"} なし
本文が大きすぎる、JSONが配列や文字列 {"ok":false,"error":"bad request"} なし
JSONではない文字列 {"ok":false,"error":"server error"} なし(ログは「JSON parse error」だけ)
「受信ログ」シートがない {"ok":false,"error":"server error"} なし(ロックは解放される)

ローカルの Node.js モックで doPost を27ケース実行したターミナル(failures=0。実GAS・実シートの結果ではありません)

なお、公式ドキュメントでは、c と sid はシステムが使う名前なので、URLのパラメータやPOSTの本文で使わないように、と案内されています。送るデータの項目名には別の名前を使いましょう。


手順4:ウェブアプリとしてデプロイする

公式ドキュメント Web Apps の手順に沿って、ウェブアプリとして公開します(表記は公式ドキュメントの英語に合わせています。日本語表示の画面では名前が違うことがあります)。

  1. エディタ右上の Deploy → New deployment をクリックする
  2. 「Select type」の横の歯車アイコン(Enable deployment types)から Web app を選ぶ
  3. 「Deployment configuration」の欄に説明(例:受信ログ v1)を入れ、実行するユーザーは自分(デプロイした人として実行)、アクセスできる範囲は「ログインしていない人も含めて誰でも」を選ぶ(マニフェストの説明では、それぞれ USER_DEPLOYING と ANYONE_ANONYMOUS にあたります)
  4. Deploy をクリックし、初回は承認の画面で内容を確認して許可する
  5. 表示されたウェブアプリのURL(末尾が /exec)をコピーする

アクセスできる範囲を「誰でも」にすると、URLを知っている人なら誰でもリクエストを送れることになります。だからこそ、手順2の合言葉チェックが大事になります。URLも合言葉も、人に見せたり公開リポジトリに上げたりしないでください。

ここで、つまずきやすいポイントが2つあります。

  • Deploy → Test deployments で出る /dev で終わるURLは、スクリプトの編集権限がある人しか使えない、開発中の確認用です。Pythonから送るときは /exec のURLを使います
  • コードを直したあとは、デプロイし直さないと /exec には反映されません。Deploy → Manage deployments から今のデプロイを編集し、新しいバージョンを選んでデプロイし直します

手順5:Python から送る

Python 側では、URLと合言葉を環境変数に入れておきます。Mac・Linux の場合はこうです。

  • 1
  • 2
export GAS_WEBAPP_URL='https://script.google.com/macros/s/(ここにコピーしたID)/exec'
export GAS_WEBAPP_TOKEN='(手順2で作った合言葉)'

Windows の PowerShell なら $env:GAS_WEBAPP_URL = '...' と $env:GAS_WEBAPP_TOKEN = '...' です。.env で管理する方法は APIキーをコードに直書きしない|.envと環境変数で安全に管理する(Python・GAS) で解説しています。

次の内容を send_to_sheet.py として保存します。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
"""GAS のウェブアプリへ JSON を送って、スプレッドシートに1行追記してもらう。
URL と合言葉は環境変数 GAS_WEBAPP_URL / GAS_WEBAPP_TOKEN から読む。
"""
import os
import sys

import requests


def send_row(name: str, value: float) -> None:
    url = os.environ.get("GAS_WEBAPP_URL")
    token = os.environ.get("GAS_WEBAPP_TOKEN")
    if not url or not token:
        raise RuntimeError("環境変数 GAS_WEBAPP_URL と GAS_WEBAPP_TOKEN を設定してください")

    res = requests.post(url, json={"token": token, "name": name, "value": value}, timeout=30)
    res.raise_for_status()
    result = res.json()           # この例のGASは失敗もJSONの ok で返すので、中身を確認する
    if not result.get("ok"):
        raise RuntimeError(f"書き込みに失敗しました: {result.get('error')}")


if __name__ == "__main__":
    send_row("dummy-task", 3)
    print("スプレッドシートに追記しました")

ローカルのモックへ POST→302→GET したターミナル(実Google・実シートへの送信結果ではありません)

python3 send_to_sheet.py を実行して「スプレッドシートに追記しました」と表示されたら、GASから {"ok": true} が返ってきたという意味です(このメッセージは、返事を確認したあとに Python 側が表示しているものです)。最後に「受信ログ」シートを開いて、1行増えていることを確かめましょう。

なお、この記事で動かして確かめたのは、練習用のローカルサーバーに送ったところまでです。実際のGoogleのウェブアプリやスプレッドシートでの実行結果は載せていません。

ここで知っておきたいのが、リダイレクトです。公式ドキュメントによると、ContentService が返す内容は、セキュリティのため script.googleusercontent.com の一度きりのURLにリダイレクトされます。そのため、HTTPクライアントはリダイレクトをたどる設定にしておく必要があります(curl なら -L を付けます)。

requests は、初期設定でリダイレクトを自動でたどります。練習用サーバーで同じ動き(POSTを受けたら302で別のURLへ案内)を再現したところ、requests は自動でそのURLへGETでアクセスし直し、JSONの返事を受け取っていました。

  • 1
  • 2
[mock] POST /macros/s/DUMMY/exec HTTP/1.1 -> 302
[mock] GET /echo HTTP/1.1 -> 200

合言葉を間違えた状態で実行すると、RuntimeError: 書き込みに失敗しました: unauthorized で止まりました。環境変数が空のときは、RuntimeError: 環境変数 GAS_WEBAPP_URL と GAS_WEBAPP_TOKEN を設定してください で止まります。

自分のデータに合わせて改造するときは、AIにこう頼むとスムーズです。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
GASのウェブアプリ(doPost)でJSONを受け取り、スプレッドシートに追記しています。
送る項目を増やしたいので、GASとPythonの両方のコードを直してください。

【条件】
- 合言葉はスクリプトプロパティ WEBAPP_TOKEN と比べる。合わないときは書き込まない
- LockService で1件ずつ書き込む形は残す
- 結果は {"ok": true} / {"ok": false, "error": "..."} のJSONで返す
- Python側のURLと合言葉は環境変数 GAS_WEBAPP_URL / GAS_WEBAPP_TOKEN から読む
- 追加したい項目:(例:date, category, memo)

【今のGASコード】
(ここに貼る。合言葉・スプレッドシートのID・ウェブアプリURLの実物は貼らない)

【今のPythonコード】
(ここに貼る。URLや合言葉の実物は貼らない)

POSTのリトライは慎重に

外部APIの一時的な失敗に備える|Pythonのリトライと指数バックオフ(requests) でも触れたとおり、POSTを自動でリトライすると、同じ行が2回追記されることがあります。たとえば、GAS側では書き込みが終わっていたのに、返事が届く前にPython側がタイムアウトした場合です。

この例の send_row は、あえてリトライを入れていません。失敗したらエラーで止まるので、シートを見て追記されたかどうかを確かめてから、必要なら送り直してください。どうしても自動で送り直したい場合は、送るデータに一意のID(例:日付+連番)を入れておき、GAS側で同じIDがすでにあれば追記しない、といった重複チェックを足すのが安全です。


セキュリティの注意

  • 公開URLを知っていることだけを認証の代わりにせず、長いランダムな合言葉をJSONの本文で送って照合します。合言葉をURLのパラメータに入れたり、コードやログに残したりしないでください
  • 受け取った値は、確かめてからシートに書きます。appendRow は、「=」で始まる文字列を数式として扱うと公式リファレンスに書かれています。上のコードでは、前後の空白を取り除いたうえで、先頭が =・+・-・@(全角も)の名前と、制御文字を含む名前を受け付けていません。+・-・@ まで拒否しているのは、CSVで書き出して別のアプリで開くときのための備えです。それでも、すべてのパターンを防げるわけではありません。また、文字列がスプレッドシート側で数値や日付に自動で変換されることもあるので、気になる場合は実際のシートで確かめてください。本文の大きさは1万文字までにしていますが、送られてくる回数の制限は入っていません。GASには1日あたりの実行回数などの上限(割り当て)もあるので、公開して使うときは用途に合わせて考えてください
  • このコードには送信回数の制限がないため、URLと合言葉が漏れると、大量の書き込みなどの乱用は防げません。実際のサービスでは確かめていないので、この記事のコードは練習用のシートで、本物の個人情報を入れずに使ってください。漏れたと思ったら、合言葉を作り直してスクリプトプロパティを差し替え、必要ならデプロイも作り直します
  • 数値は、型・範囲も確かめます。Number("abc") のような変換は NaN になるので、文字列を無理に数値に変えずに拒否しています
  • POSTを自動で送り直すと、同じ行が二重に追記されることがあります

参考:Sheet.appendRow(Google 公式リファレンス)、Content Service(Google 公式)


つまずきやすい点

症状 原因 対処
unauthorized が返る 合言葉が違う、スクリプトプロパティ名の打ち間違い WEBAPP_TOKEN と環境変数の値を見直す(前後の空白にも注意)
コードを直したのに動きが変わらない デプロイし直していない Manage deployments で新しいバージョンとしてデプロイし直す
JSONではなくHTMLのページが返ってくる /dev のURLを使っている、アクセスできる範囲が「誰でも」になっていない、またはエラーページが返っている /exec のURLか、デプロイの設定を確認する。GASの「実行数」にエラーが出ていないかも見る
server error が返る シート名の違いなど、GAS側のエラー GASの「実行数」で console.error の内容を確認する
同じ行が2回追記された タイムアウト後に送り直した 送る前に重複チェックの仕組みを入れる

困ったときは、こんなふうに相談してみてください。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
PythonのrequestsからGASのウェブアプリ(/exec)にJSONをPOSTしています。
返事のJSONが想定と違います。原因の候補と確認する順番を教えてください。

【返ってきた内容(先頭だけ)】
(ここに貼る)

【GASのデプロイ設定】
実行するユーザー:自分(USER_DEPLOYING)/アクセスできる範囲:誰でも(ANYONE_ANONYMOUS)

※ URLのIDや合言葉は伏せています

まとめ

  • GASに doPost(e) を書くと、POSTされた本文を e.postData.contents で受け取れる
  • 誰でもアクセスできる形で公開するなら、合言葉チェックは必須
  • LockService で同時の書き込みを1件ずつにする
  • 結果はJSONの ok で返し、Python側で確認する
  • ContentService の返事はリダイレクトされる。requests は自動でたどってくれる
  • コードを直したら、デプロイし直すのを忘れない

次の一歩は、今Pythonで集めている数字を1つだけ選んで、send_row で毎日「受信ログ」に貯めてみることです。貯まったデータは、GASからSlackに通知する|Incoming WebhookのURLをスクリプトプロパティで安全に使う の方法で毎朝Slackにまとめて送ることもできます。


関連する本・記事

スプレッドシートを起点にした自動化を、生成AIの手を借りながら広げていきたい方は、『Google Apps Script × 生成AI 全自動仕事術』も参考になります。

より詳しく知りたいときは、公式ドキュメントの Web Apps(Apps Script)、Content Service(Apps Script)、Class LockService(Apps Script) も参考になります。