Raspberry Pi の Node-RED から Google スプレッドシートにデータを書き込む設定手順

2026年6月5日

Raspberry Pi で収集したセンサーデータを Google スプレッドシートに記録したい——そのためには GCP のサービスアカウント認証と Node-RED の node-red-contrib-google-sheets ノードが必要です。本記事では GCP 側の設定から Node-RED のフロー構築・動作確認まで、一連の手順を解説します。同様の IoT データ収集基盤を検討している方にも応用できる内容です。

GCP の事前設定

1. Google Sheets API の有効化

課題:外部サービスから Google スプレッドシートを操作するには API の有効化が必要です。
解決策:GCP コンソールのライブラリから Google Sheets API を有効にします。

GCP コンソールにログインし、左メニューの「API とサービス」→「ライブラリ」を開きます。

GCP コンソールの API とサービス→ライブラリのメニュー

検索欄に「sheet」と入力して Google Sheets API を選択し、「有効にする」をクリックします。

API ライブラリで Google Sheets API を検索した画面
Google Sheets API の有効化ボタン

2. サービスアカウントと秘密鍵の作成

課題:Node-RED(Raspberry Pi)から Google Sheets API を呼び出すには認証情報が必要です。
解決策:GCP のサービスアカウントを作成し、JSON 形式の秘密鍵をダウンロードします。

GCP コンソールの「IAM と管理」→「サービスアカウント」を開き、「サービスアカウントを作成」をクリックします。

GCP の IAM と管理→サービスアカウントのメニュー

任意のサービスアカウント名を入力して「完了」をクリックします。作成後、操作メニューから「鍵の作成」を選択します。

サービスアカウントの操作メニューから鍵の作成を選択

キーのタイプとして「JSON」を選択して「作成」をクリックすると、xxxxx.json という名前の秘密鍵ファイルが自動ダウンロードされます。

JSON タイプの秘密鍵を選択するダイアログ

この JSON ファイルは認証情報そのものです。安全な場所に保管し、第三者に共有しないでください。

Google スプレッドシートの共有設定

書き込み先のスプレッドシートを作成し、右上の「共有」ボタンをクリックします。

スプレッドシートの共有ボタン

ユーザー追加欄に、先ほどダウンロードした xxxxx.json 内の client_email の値を貼り付けます。

"client_email": "YOUR_SERVICE_ACCOUNT@YOUR_PROJECT.iam.gserviceaccount.com"

権限を「編集者」に設定して「共有」をクリックすれば、スプレッドシート側の準備は完了です。

サービスアカウントのメールアドレスでスプレッドシートを共有した状態

Node-RED の設定

1. node-red-contrib-google-sheets のインストール

Node-RED の右上メニューから「パレットの管理」を開き、node-red-contrib-google-sheets を検索してインストールします。

Node-RED のパレットの管理メニュー

2. Gsheet ノードの設定

Gsheet ノードをフローに配置し、以下の項目を設定します。

Gsheet ノードの設定画面
  • creds:鉛筆アイコンをクリックし、ダウンロードした xxxxx.json の中身をそのまま貼り付ける
  • Method:Update Cells を選択
  • SpreadsheetID:スプレッドシートの URL から取得する(https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit の太字部分)
  • Cells:書き込みたいセル範囲を指定(例: sheet1!C2)
credentials に JSON ファイルの内容を貼り付ける画面

3. フロー全体の構成

動作確認用のシンプルなフローは以下の 3 ノード構成です。

Inject → Function(create payload)→ Gsheet → Debug のフロー構成

Function ノード(create payload)でスプレッドシートに書き込む値を msg.payload に設定します。Gsheet ノードは msg.payload の値を書き込みます。

Function ノードで msg.payload に書き込む値を設定するコード例

動作確認:Inject ノードの実行とスプレッドシートへの書き込み確認

Inject ノード左のボタンをクリックしてフローを実行します。Node-RED のデバッグパネルに正常終了メッセージが表示されれば成功です。

Node-RED デバッグパネルに正常終了メッセージが表示された画面

数秒後にスプレッドシートを確認すると、指定したセルに値が書き込まれています。

Google スプレッドシートに値が書き込まれた画面

まとめ:Node-RED から Google スプレッドシートへのデータ書き込みを最小手順で実現

  • GCP のサービスアカウントと JSON 秘密鍵で、OAuth 認証なしにシンプルな API 認証を実現できる
  • node-red-contrib-google-sheets ノードを使うことで、専用コードなしにスプレッドシートへの書き込みを実装できる
  • Gsheet ノードは msg.payload を書き込み値として使うため、前段の Function ノードでデータを整形するだけで済む
  • スプレッドシートをデータストアにすることで、Glide や AppSheet でのノーコードアプリ化がスムーズになる