GASのCacheServiceでAPI結果を
一時保存して高速化する方法

function cacheBasics() {
  const cache = CacheService.getScriptCache();

  // 保存: put(キー, 値, 有効期限の秒数)
  // 値は文字列のみ。第3引数は最大21600秒（6時間）、省略時は600秒
  cache.put("rate_usd", "156.3", 3600); // 1時間

  // 取得: 無ければ null が返る
  const value = cache.get("rate_usd");
  Logger.log(value); // "156.3"（文字列で返る点に注意）

  // 削除
  cache.remove("rate_usd");
}

// 外部APIの結果を1時間キャッシュする「キャッシュ優先」パターン
function getExchangeRate() {
  const cache = CacheService.getScriptCache();
  const key = "usd_jpy";

  // 1. まずキャッシュを見る
  const cached = cache.get(key);
  if (cached !== null) {
    return Number(cached); // ヒットしたら即返す（APIを呼ばない）
  }

  // 2. 無ければ本体（外部API）を実行
  const res = UrlFetchApp.fetch("https://api.example.com/rate/usdjpy");
  const rate = JSON.parse(res.getContentText()).rate;

  // 3. 結果をキャッシュに保存して返す
  cache.put(key, String(rate), 3600);
  return rate;
}

// オブジェクトや配列は JSON にしてから保存する
function cacheObject() {
  const cache = CacheService.getScriptCache();

  const data = { name: "山田太郎", items: ["A", "B", "C"] };

  // 保存: 文字列化（JSON.stringify）
  cache.put("profile", JSON.stringify(data), 1800);

  // 取得: null チェックしてから復元（JSON.parse）
  const raw = cache.get("profile");
  if (raw === null) {
    return null; // 期限切れ or 未保存
  }
  const restored = JSON.parse(raw);
  Logger.log(restored.items.length); // 3
  return restored;
}

// 多数のキーをまとめて読み書きすると通信回数が減って速い
function cacheBulk() {
  const cache = CacheService.getScriptCache();

  // 一括保存: putAll(オブジェクト, 有効期限)
  cache.putAll(
    {
      user_1: JSON.stringify({ name: "田中" }),
      user_2: JSON.stringify({ name: "佐藤" }),
      user_3: JSON.stringify({ name: "鈴木" }),
    },
    600
  );

  // 一括取得: getAll(キー配列) → { キー: 値 } が返る（無いキーは含まれない）
  const found = cache.getAll(["user_1", "user_2", "user_9"]);
  Logger.log(Object.keys(found)); // ["user_1", "user_2"]（user_9 は未ヒット）

  // 一括削除
  cache.removeAll(["user_1", "user_2", "user_3"]);
}

// 3種類のストアを用途で使い分ける
function cacheStores() {
  // 全ユーザー共通のデータ（為替、共通マスタなど）
  const scriptCache = CacheService.getScriptCache();

  // 実行しているユーザーごとに分けたいデータ（その人の検索結果など）
  const userCache = CacheService.getUserCache();

  // 特定のスプレッドシート/フォームに紐づくデータ
  const docCache = CacheService.getDocumentCache();

  scriptCache.put("shared_master", "v2026-07", 21600);
  userCache.put("last_search", "GAS 高速化", 600);
  if (docCache) docCache.put("sheet_state", "ready", 600);
}

// 重い集計結果をキャッシュしてダッシュボードを高速化する例
function getDashboardSummary() {
  const cache = CacheService.getScriptCache();
  const key = "dashboard_summary";

  const cached = cache.get(key);
  if (cached !== null) {
    return JSON.parse(cached);
  }

  // ここが重い処理（大量行の集計など）
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const rows = sheet.getDataRange().getValues().slice(1);
  const total = rows.reduce((sum, r) => sum + Number(r[3] || 0), 0);
  const summary = { total: total, count: rows.length };

  // 10分キャッシュ。次のアクセスは即返る
  cache.put(key, JSON.stringify(summary), 600);
  return summary;
}