GASを利用してEvent WebhookのデータをGoogle スプレッドシートに出力する

Twilio SendGridのEvent Webhookを使うと、アカウントで発生したイベント情報を外部環境にPOSTできることをご存じですか？POSTデータの受信環境を整えておけば、ログとして保存できるだけでなくデータ分析などにも活用できるため、設定しておくことをお勧めしています。

しかし、この機能を使うには受信データを処理する仕組みを自分で構築する必要があります。便利な機能ではありますが、サーバやプログラミングの知識がない方にとっては少し手を出しづらいかもしれません。

そこで今回は、Googleが提供するローコードプラットフォームであるGoogle Apps Script（GAS）を利用して、SendGridのイベントデータをGoogle スプレッドシートに保存する方法をご紹介します。

GASはGoogleアカウントを所有していれば無料で利用できるので、Event Webhookの受信環境をお手軽に構築したい方はぜひご一読ください！

必要なもの

GASの準備

1. データ出力用のGoogle スプレッドシートを作成し、Apps Scriptを開く

メニューバーの「拡張機能」→「Apps Script」を選択します。

メニューバーの「拡張機能」→「Apps Script」を選択

「無題のプロジェクト」という名称の新しいApps Scriptが開きます。適宜プロジェクト名を変更してください。

2. 受信データをスプレッドシートに書き出す処理を実装する

今回使用したサンプルコードを以下に示します。
Event Webhookで受け取ったJSONのデータを解析し、パラメータ毎に出力する、といった流れとなっています。イベントによって含まれるパラメータが異なるので適宜ヘッダが追加できるようにしています。

function doPost(e){
  // POSTデータ取り出し
  let postContent = e.postData.getDataAsString();
 
  // POSTデータをオブジェクト型に変換
  let json = JSON.parse(postContent);
  // 出力するシートを取得
  let sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  let headerRow = sheet.getDataRange().getValues()[0];


  // ヘッダがない場合1件目のパラメータを基準にヘッダを作成する
  if(headerRow.length == 1 && headerRow[0] == ""){
    let index = 1;
    for(let param in json[0]){
      let header = sheet.getRange(1, index);
      header.setValue(param);
      index++;
    }
    // 変数の更新
    headerRow = sheet.getDataRange().getValues()[0];
  }


  for(i = 0; i < json.length; i++){
    // 最終行を取得
    let lastRow = sheet.getLastRow();
    // スプレッドシートのヘッダと比較してパラメータがあるかチェック
    for(let param in json[i]){
      let addColNum = headerRow.indexOf(param) + 1;
      if(addColNum == 0){
        // スプレッドシートのヘッダにパラメータが存在しないのでヘッダ追加
        let headerRange = sheet.getRange(1, headerRow.length + 1);
        headerRange.setValue(param);
        // ヘッダ情報を更新
        headerRow = sheet.getDataRange().getValues()[0];
        addColNum = headerRow.length;
      }
     
      // データを追加
      let range = sheet.getRange(lastRow + 1, addColNum);
      range.setValue(json[i][param]);
    }
  }
}

コードの入力が完了したらアイコンをクリックして保存します。

アイコンをクリックして保存