Google Apps Script Web App の「直したのに反映されない」を構造的に潰す

前提

• GAS プロジェクトは clasp で管理し、Web App エンドポイントは https://script.google.com/macros/s/<スクリプトID>/exec とする。
• 認証は外部トークン（例: API Gateway で発行）で行い、ANYONE_ANONYMOUS かつ USER_DEPLOYING の設定で動作させる。

罠その1 – clasp push の限界

• clasp push は HEAD（ローカルの最新コード） をスクリプトファイルに反映するだけ。
• バージョン付きデプロイ（/exec が参照するもの）には自動で反映されない。
• そのため push 後に /exec で旧コードが返り続ける。

罠その2 – 既存デプロイの上書きは失敗しやすい

• clasp deploy --deploymentId <既存ID> を実行すると、コンソールは
  Deployed ... @31 と 成功 を表示するが、実際には 古いコードが返り続けた（実測）。
• 新規デプロイ (clasp deploy ID 指定なし) を作成した瞬間に新コードが配信される。
• 既存デプロイを上書きすると アクセス権がリセット され、401/404 エラーになるケースがある。

罠その3 – 成功判定の誤り

• 「デプロイ成功表示」や「レスポンス長」だけで成功とみなすと偽陽性が多発。
• 正しい判定は 「新しく追加したキー／アクションがレスポンスに含まれるか」 で行う。
• 典型的な症状: 新規アクション呼び出しが Unknown action を返し続ける。

解決策 – 「push → 新規デプロイ → 認証情報 URL 差し替え → 疎通確認」を自動化

1. clasp push でローカルコードを HEAD に反映。
2. clasp deploy で 新規デプロイ を作成し、取得した デプロイ ID と Web App URL を取得。
3. tools/.gas-credentials.json（形式 { "url": "...", "token": "..." }）の url を新しい URL に上書き。
4. Invoke‑RestMethod で 新規アクション（例: getStatus）を呼び、期待キーが返るか確認。
5. 成功したら 1 行だけ 「✅ Deploy succeeded」と出力し、以降はそのスクリプトだけを実行。

必須設定 – appsscript.json

{
  "timeZone": "Asia/Tokyo",
  "exceptionLogging": "STACKDRIVER",
  "webapp": {
    "executeAs": "USER_DEPLOYING",
    "access": "ANYONE_ANONYMOUS"
  }
}

• 上記をプロジェクトに入れておけば、新規デプロイ時に追加設定は不要。

Windows PowerShell 実装時の落とし穴

完成例 – tools/gasdeploy.ps1

<#
.SYNOPSIS
    GAS の push → 新規デプロイ → 認証情報書き換え → 疎通確認 を一括実行
.PARAMETER Description
    デプロイ時の説明文（任意）。省略すると "Auto deploy $(Get-Date -Format o)" になる。
.PARAMETER SkipPush
    $true にすると clasp push をスキップ。デバッグ時に利用。
#>

param(
    [string]$Description = "Auto deploy $(Get-Date -Format o)",
    [switch]$SkipPush
)

# --- 定数・パス ---
$repoRoot      = Split-Path -Parent $MyInvocation.MyCommand.Path | Resolve-Path -Relative
$credPath      = Join-Path $repoRoot "tools/.gas-credentials.json"
$pushResult    = $null
$newDeployId   = $null
$newUrl        = $null

# --- 1. clasp push (任意) ---
if (-not $SkipPush) {
    Write-Host "▶ clasp push ..."
    $pushResult = clasp push 2>&1
    $joined = ($pushResult | Out-String)
    if ($joined -notmatch 'Pushed') {
        Write-Error "clasp push に失敗: $joined"
        exit 1
    }
    Write-Host "✅ push 完了"
} else {
    Write-Host "⚠ SkipPush 指定: push を省略"
}

# --- 2. 新規デプロイ ---
Write-Host "▶ clasp deploy (新規) ..."
$deployOut = clasp deploy -d "$Description" 2>&1
$joinedDeploy = ($deployOut | Out-String)
if ($joinedDeploy -notmatch 'Deployed') {
    Write-Error "clasp deploy に失敗: $joinedDeploy"
    exit 1
}
# 例: "Deployed as version 42 (deploymentId: <デプロイID>)"
if ($joinedDeploy -match 'deploymentId:\s*([^\s)]+)') {
    $newDeployId = $matches[1]
} else {
    Write-Error "deploymentId が取得できません: $joinedDeploy"
    exit 1
}
if ($joinedDeploy -match 'https://script.google.com/macros/s/([^/]+)/exec') {
    $newUrl = "https://script.google.com/macros/s/$($matches[1])/exec"
} else {
    Write-Error "Web App URL が取得できません"
    exit 1
}
Write-Host "✅ 新規デプロイ ID: $newDeployId"
Write-Host "✅ 新 Web App URL: $newUrl"

# --- 3. 認証情報 JSON のバックアップと書き換え ---
if (-Not (Test-Path $credPath)) {
    Write-Error "認証情報ファイルが見つかりません: $credPath"
    exit 1
}
$backupPath = "$credPath.bak_$(Get-Date -Format 'yyyyMMddHHmmss')"
Copy-Item -Path $credPath -Destination $backupPath -Force
Write-Host "🔄 認証情報バックアップ: $backupPath"

$credJson = Get-Content -Path $credPath -Raw | ConvertFrom-Json
$credJson.url = $newUrl
$credJson | ConvertTo-Json -Depth 10 | Set-Content -Path $credPath -Encoding UTF8
Write-Host "✅ 認証情報 URL を更新"

# --- 4. 疎通確認（新規アクション getStatus） ---
$testAction = @{ action = "getStatus" } | ConvertTo-Json -Compress
$bodyBytes  = [System.Text.Encoding]::UTF8.GetBytes($testAction)

Write-Host "▶ 疎通確認 (getStatus) ..."
try {
    $response = Invoke-RestMethod -Method Post `
        -Uri $newUrl `
        -Headers @{ "Authorization" = "Bearer $($credJson.token)" } `
        -Body $bodyBytes `
        -ContentType "application/json; charset=utf-8" `
        -MaximumRedirection 5 `
        -ErrorAction Stop
} catch {
    Write-Error "疎通確認に失敗: $_"
    exit 1
}

if ($response -and $response.status -eq "ok") {
    Write-Host "✅ Deploy succeeded"
    exit 0
} else {
    Write-Error "期待キーがレスポンスに無い: $($response | ConvertTo-Json -Compress)"
    exit 1
}

完了前のチェックリスト

• clasp push が成功し、Pushed が出力に含まれる。
• clasp deploy が新規デプロイを作成し、deploymentId と Web App URL が取得できている。
• tools/.gas-credentials.json のバックアップが作成され、url が新 URL に書き換わっている。
• Invoke‑RestMethod が 302 リダイレクトを追従し、UTF‑8 バイト列でボディを送信できている。
• getStatus（または任意の新規アクション）から期待キー status: "ok" が返ってくる。
• スクリプト実行後、コンソールに 「✅ Deploy succeeded」 が 1 行だけ表示される。
• 失敗した場合は Error メッセージが出力され、スクリプトは非 0 終了コードで終了する。