Google Looker Studio × Gemini API でビジネスレポートをAI自動分析する

// ============================================================
// Gemini API × Looker Studio 自動分析スクリプト
// Google AI Studio から取得した API キーを設定してください
// ============================================================
 
const GEMINI_API_KEY = "YOUR_GEMINI_API_KEY"; // ← AI Studio から取得
const GEMINI_MODEL   = "gemini-2.5-flash";
const ANALYSIS_SHEET = "AI_Analysis";
const DATA_SHEET     = "Sales_Data";
 
/**
 * メイン関数：データを取得し Gemini API で分析してシートに書き込む
 * トリガーで毎日 09:00 に自動実行するよう設定します
 */
function runGeminiAnalysis() {
  const ss   = SpreadsheetApp.getActiveSpreadsheet();
  const data = fetchSalesData(ss);
 
  if (!data || data.length === 0) {
    Logger.log("分析対象データが見つかりませんでした");
    return;
  }
 
  // 直近7日分のサマリーを作成
  const summary = buildDataSummary(data);
  Logger.log("データサマリー: " + summary);
 
  // Gemini API に送信して分析コメントを生成
  const analysis = callGeminiApi(summary);
 
  // 結果を AI_Analysis シートに書き込み
  writeAnalysisResult(ss, analysis);
  Logger.log("✅ 分析完了 — シートに書き込みました");
}
 
/**
 * Sales_Data シートから直近7日のデータを取得する
 */
function fetchSalesData(ss) {
  const sheet  = ss.getSheetByName(DATA_SHEET);
  if (!sheet) throw new Error(DATA_SHEET + " シートが見つかりません");
 
  const rows   = sheet.getDataRange().getValues();
  const header = rows[0]; // 1行目はヘッダー
  const today  = new Date();
  const oneWeekAgo = new Date(today - 7 * 24 * 60 * 60 * 1000);
 
  // 直近7日分のデータをフィルタリング
  return rows.slice(1).filter(row => {
    const dateVal = row[0];
    if (!dateVal) return false;
    const d = dateVal instanceof Date ? dateVal : new Date(dateVal);
    return d >= oneWeekAgo && d <= today;
  });
}
 
/**
 * データを Gemini API に送りやすいテキストサマリーに変換する
 */
function buildDataSummary(data) {
  let totalSales    = 0;
  let totalCustomers = 0;
  const catMap      = {};
 
  data.forEach(row => {
    const sales    = parseFloat(row[1]) || 0;  // B列: 売上
    const category = String(row[2] || "不明"); // C列: カテゴリ
    const customers= parseFloat(row[3]) || 0;  // D列: 顧客数
 
    totalSales    += sales;
    totalCustomers += customers;
    catMap[category] = (catMap[category] || 0) + sales;
  });
 
  const catLines = Object.entries(catMap)
    .sort((a, b) => b[1] - a[1])
    .map(([cat, s]) => `  - ${cat}: ¥${s.toLocaleString()}`)
    .join("\n");
 
  return [
    `【直近7日間の売上サマリー】`,
    `合計売上: ¥${totalSales.toLocaleString()}`,
    `合計顧客数: ${totalCustomers}人`,
    `カテゴリ別売上:`,
    catLines,
    `データ件数: ${data.length}行`,
  ].join("\n");
}
 
/**
 * Gemini API を呼び出して AI 分析コメントを取得する
 */
function callGeminiApi(summary) {
  const prompt = `
あなたはビジネスアナリストです。以下の売上データを分析し、以下の形式で回答してください。
 
【データ】
${summary}
 
【出力形式】
1. 現状分析（2〜3文で要点をまとめてください）
2. 注目すべきポイント（箇条書き2〜3点）
3. 推奨アクション（具体的な施策を1〜2点）
 
簡潔かつ実用的な内容でお願いします。
  `.trim();
 
  const url     = `https://generativelanguage.googleapis.com/v1beta/models/${GEMINI_MODEL}:generateContent?key=${GEMINI_API_KEY}`;
  const payload = {
    contents: [{ parts: [{ text: prompt }] }],
    generationConfig: {
      temperature: 0.3,        // 分析用途は低め（一貫性重視）
      maxOutputTokens: 1024,
    },
  };
 
  const response = UrlFetchApp.fetch(url, {
    method: "POST",
    contentType: "application/json",
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });
 
  const statusCode = response.getResponseCode();
  if (statusCode !== 200) {
    const errorBody = response.getContentText();
    throw new Error(`Gemini API エラー (HTTP ${statusCode}): ${errorBody}`);
  }
 
  const result = JSON.parse(response.getContentText());
 
  // レスポンスからテキストを抽出
  const text = result?.candidates?.[0]?.content?.parts?.[0]?.text;
  if (!text) throw new Error("Gemini API からテキストが返されませんでした");
 
  return text;
}
 
/**
 * 分析結果を AI_Analysis シートに書き込む
 */
function writeAnalysisResult(ss, analysisText) {
  let sheet = ss.getSheetByName(ANALYSIS_SHEET);
  if (!sheet) {
    sheet = ss.insertSheet(ANALYSIS_SHEET);
    // ヘッダー行を追加
    sheet.appendRow(["分析日時", "対象期間", "AI分析コメント", "推奨アクション"]);
  }
 
  const now    = new Date();
  const period = `${formatDate(new Date(now - 7 * 24 * 60 * 60 * 1000))} 〜 ${formatDate(now)}`;
 
  // 分析コメントと推奨アクションを分割（簡易パース）
  const lines       = analysisText.split("\n").filter(l => l.trim());
  const mainComment = lines.slice(0, Math.ceil(lines.length * 0.7)).join("\n");
  const actionPart  = lines.slice(Math.ceil(lines.length * 0.7)).join("\n");
 
  sheet.appendRow([now, period, mainComment, actionPart]);
}
 
/** 日付を YYYY-MM-DD 形式にフォーマット */
function formatDate(d) {
  return Utilities.formatDate(d, "Asia/Tokyo", "yyyy-MM-dd");
}