概要

本記事では、子供のポケモンカード対戦記録をSlackのスラッシュコマンドからGoogle Spread Sheetsへ自動入力するシステムを構築した過程をまとめます。

単純なAPI連携の過程を記載するだけでなく、「サーバーレス特有の制約（Slack 3秒ルール）」や「セキュリティと環境変数の設計」、「暗号鍵フォーマットのトラブルシューティング」なども盛り込んでいます。

動機

日常の何かにITを使いたいと思ったのと、親子でポケカをしており、対戦記録を家族で共有、記録出来ればと思ったため。

構成

Slack → API Gateway → Lambda → Google Spread Sheets

スラックコマンドを入力すると、slackに通知が飛び、内容がスプレッドシートに記録されます

1. 受付レイヤー (Slack & API Gateway)

ユーザー: /pokeca [名前] [結果] [デッキ] と打つだけ。
インフラ: Slackからの application/x-www-form-urlencoded 形式のPOSTリクエストを、API Gatewayが受け取り、Lambdaへ橋渡し（プロキシ）します。

2. ロジックレイヤー (AWS Lambda)

使用コード

GOOGLE_SETTINGS、SPREADSHEET_ID部分はlambdaの変数設定を利用しています。

import json
import base64
import gspread
import os
from urllib.parse import parse_qs
from datetime import datetime

def lambda_handler(event, context):
    try:
        # --- 1. 環境変数から設定を読み込む ---
        # Google CloudのサービスアカウントJSON（まるごと）
        key_json_str = os.environ.get('GOOGLE_SETTINGS')
        # 対象のスプレッドシートID
        spreadsheet_id = os.environ.get('SPREADSHEET_ID')
        
        if not key_json_str or not spreadsheet_id:
            return response_to_slack("エラー：環境変数が正しく設定されていません。")
            
        service_account_info = json.loads(key_json_str)
        
        # 秘密鍵の改行コードを修正（環境変数を経由する際の必須処理）
        service_account_info['private_key'] = service_account_info['private_key'].replace('\\n', '\n')

        # --- 2. Slackからのデータ受け取り ---
        body = event.get('body', '')
        if event.get('isBase64Encoded'):
            body = base64.b64decode(body).decode('utf-8')
        
        params = parse_qs(body)
        user_text = params.get('text', [''])[0]
        words = user_text.split()
        
        if len(words) < 3:
            return response_to_slack("形式エラー！「名前 勝敗 デッキ」の順で入力してね。", ephemeral=True)

        name, result, deck = words[0], words[1], words[2]
        date_str = datetime.now().strftime('%Y/%m/%d %H:%M')

        # --- 3. Google Sheetsへの接続と書き込み ---
        gc = gspread.service_account_from_dict(service_account_info)
        sh = gc.open_by_key(spreadsheet_id)
        worksheet = sh.get_worksheet(0) # 1枚目のシートを指定

        # データの追記（日付, 対戦相手, 勝敗, デッキ）
        worksheet.append_row([date_str, name, result, deck])

        return response_to_slack(f"✅ 記録完了！\n日付: {date_str}\n対戦相手: {name}\n結果: {result}\nデッキ: {deck}")

    except Exception as e:
        # ログ出力（CloudWatch用）
        print(f"Error: {str(e)}")
        return response_to_slack(f"エラーが発生しました: {str(e)}", ephemeral=True)

def response_to_slack(message, ephemeral=False):
    """Slackへのレスポンスフォーマットを作成"""
    response_body = {
        'response_type': 'ephemeral' if ephemeral else 'in_channel',
        'text': message
    }
    return {
        'statusCode': 200,
        'headers': {'Content-Type': 'application/json'},
        'body': json.dumps(response_body, ensure_ascii=False)
    }

Runtime: Python 3.12を使用。
スプレッドシート連携するため、レイヤーにKlayers（gspread が含まれている公開レイヤー）を追加しました。

タイムアウト対応

構成を一通り作成して検証した際、Slackの3秒タイムアウト制約により operation_timeout が発生しましたが、メモリをデフォルトの128MBから512MBに変更したところ処理時間が劇的に短縮。結果として、無料枠内で安定したレスポンスを実現することが出来ました。

2025/02/04 追記
これでもたまにタイムアウトするので1024MBにしました

時刻表機ずれ対応

当初はスプレッドシートに記録される時刻がUTCでしたが、lambdaの関数設定に「TZ: Asia/Tokyo」を追加することで日本時刻で記録されるようにしました。

セキュリティへの配慮

Google Cloudの秘密鍵をコードにベタ書きせず、Lambdaの環境変数にJSONをまるごと格納して読み込む設計にしました。これにより、ソースコードの漏洩による不正アクセスのリスクを排除し、設定とロジックを分離しています。

3. データレイヤー (Google Cloud & Sheets)

1. プロジェクトの作成と API の有効化

プロジェクト作成

Google Cloud Console で新しいプロジェクトを作成。

APIの有効化

「APIとサービス」>「ライブラリ」から以下を検索し、有効化を実施しています。

Google Sheets API
Google Drive API（スプレッドシートの検索や権限確認に必要）

2. サービスアカウントの作成

プログラム専用の「身分証」を発行しています。
ロールは今回特定のシートを直接共有するため、ロール（権限）の割り当ては「なし（空）」のままで作成。

3. 秘密鍵（JSON）の発行

Lambda の環境変数GOOGLE_SETTINGSに設定した値。
作成したサービスアカウントから「新しい鍵を作成」で JSON を選択してダウンロードします。

4. スプレッドシート側の設定

書き込み先のスプレッドシートの「共有」ボタンから、サービスアカウントのメールアドレスを「編集者」として招待します。

今後の展望

この記録機能だけだいぶ味気ないので、月末などの決まったタイミングでslackに現在の勝率が通知される、溜まったデータをLambdaで集計し、勝率グラフをSlackに画像で返却する機能の追加なども出来ればと考えています。出来たらまた記事にしようと思います。