GASでSheets APIを直接使う方法
高度なサービスとbatchUpdate

{
  "timeZone": "Asia/Tokyo",
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Sheets",
        "serviceId": "sheets",
        "version": "v4"
      }
    ]
  },
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

function readValues() {
  const id = SpreadsheetApp.getActive().getId();

  // range は A1記法。シート名を付けるのが確実
  const res = Sheets.Spreadsheets.Values.get(id, "売上!A1:D100");

  const values = res.values || []; // 空のときは values 自体が返らない
  console.log("取得行数: " + values.length);
  console.log(values[0]); // ヘッダー行

  return values;
}

// 離れた4か所を「1回の呼び出し」でまとめて読む
function readSeparatedRanges() {
  const id = SpreadsheetApp.getActive().getId();

  const res = Sheets.Spreadsheets.Values.batchGet(id, {
    ranges: [
      "設定!B2:B10",   // 設定値
      "売上!A1:D1",    // ヘッダー
      "売上!A2:D500",  // 明細
      "マスタ!A2:B200", // 商品マスタ
    ],
    valueRenderOption: "UNFORMATTED_VALUE", // 表示形式を外した生の値
    dateTimeRenderOption: "FORMATTED_STRING",
  });

  const [config, header, rows, master] = res.valueRanges.map((v) => v.values || []);
  console.log("明細: " + rows.length + "行 / マスタ: " + master.length + "件");

  return { config, header, rows, master };
}

// 離れた複数範囲へ「1回の呼び出し」でまとめて書き込む
function writeSeparatedRanges() {
  const id = SpreadsheetApp.getActive().getId();

  const resource = {
    // RAW: 入力値をそのまま入れる / USER_ENTERED: 手入力と同じ解釈（数式や日付が効く）
    valueInputOption: "USER_ENTERED",
    data: [
      { range: "レポート!B2", values: [["2026年7月"]] },
      { range: "レポート!B4:B6", values: [[1200], [980], [1530]] },
      { range: "レポート!D2", values: [["=SUM(B4:B6)"]] },
      { range: "ログ!A1", values: [[new Date().toISOString()]] },
    ],
  };

  const res = Sheets.Spreadsheets.Values.batchUpdate(resource, id);
  console.log("更新セル数: " + res.totalUpdatedCells);
}

// 条件に合う行の背景色を、1回のリクエストでまとめて変える
function highlightRows(targetRowNumbers) {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("売上");
  const sheetId = sheet.getSheetId(); // シートごとの数値ID

  const requests = targetRowNumbers.map((rowNumber) => ({
    repeatCell: {
      range: {
        sheetId: sheetId,
        // GridRange は 0始まり・終端は含まない
        startRowIndex: rowNumber - 1,
        endRowIndex: rowNumber,
        startColumnIndex: 0,
        endColumnIndex: 4,
      },
      cell: {
        userEnteredFormat: {
          backgroundColor: { red: 1, green: 0.95, blue: 0.8 },
          textFormat: { bold: true },
        },
      },
      // 変更する項目だけを明示する（書かない項目は元のまま）
      fields: "userEnteredFormat.backgroundColor,userEnteredFormat.textFormat.bold",
    },
  }));

  if (requests.length === 0) return;

  Sheets.Spreadsheets.batchUpdate({ requests: requests }, ss.getId());
}

// AIで判定した結果を、まとめて1回で書き戻す
function classifyAndWriteBack() {
  const ss = SpreadsheetApp.getActive();
  const id = ss.getId();

  const res = Sheets.Spreadsheets.Values.get(id, "問い合わせ!A2:C500");
  const rows = res.values || [];

  const data = [];        // 書き戻す値
  const alertRows = [];   // 色を付ける行番号
  for (let i = 0; i < rows.length; i++) {
    const body = rows[i][1];
    const done = rows[i][2];
    if (!body || done) continue; // 空行と判定済みはスキップ

    const result = classifyWithClaude_(body);
    const rowNumber = i + 2; // A2始まりなので +2

    data.push({ range: "問い合わせ!C" + rowNumber, values: [[result.category]] });
    if (result.urgent) alertRows.push(rowNumber);
  }

  if (data.length > 0) {
    Sheets.Spreadsheets.Values.batchUpdate(
      { valueInputOption: "RAW", data: data },
      id
    );
  }
  highlightRows(alertRows); // 書式もまとめて1回
}

function classifyWithClaude_(text) {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");

  const payload = {
    model: "claude-opus-5",
    max_tokens: 512,
    system: "あなたは問い合わせを分類する担当です。必ず指定のJSON形式だけを返します。",
    messages: [{ role: "user", content: "次の問い合わせを分類してください。\n" + text }],
    output_config: {
      format: {
        type: "json_schema",
        schema: {
          type: "object",
          properties: {
            category: { type: "string", enum: ["見積依頼", "不具合", "質問", "その他"] },
            urgent: { type: "boolean" },
          },
          required: ["category", "urgent"],
          additionalProperties: false,
        },
      },
    },
  };

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: { "x-api-key": apiKey, "anthropic-version": "2023-06-01" },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  if (res.getResponseCode() !== 200) {
    console.error("Claude APIエラー: " + res.getContentText());
    return { category: "その他", urgent: false };
  }

  const json = JSON.parse(res.getContentText());
  return JSON.parse(json.content[0].text);
}

function mixedUsage() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("売上");

  // Sheets API で書き込んだ直後に SpreadsheetApp で読むときは
  // flush() でGAS側の保留分を吐き出してから読む
  sheet.getRange("A1").setValue("集計中");
  SpreadsheetApp.flush();

  const res = Sheets.Spreadsheets.Values.get(ss.getId(), "売上!A1");
  console.log(res.values[0][0]); // 集計中
}