GASでAPIキーや設定値を
PropertiesServiceに安全に保存する方法

// スクリプトプロパティからAPIキーを取り出す
function getApiKey() {
  const props = PropertiesService.getScriptProperties();
  const apiKey = props.getProperty("CLAUDE_API_KEY");

  if (!apiKey) {
    throw new Error(
      "CLAUDE_API_KEY が未設定です。プロジェクトの設定から登録してください。"
    );
  }
  return apiKey;
}

// 使う側は関数を呼ぶだけ。コードにキーの文字列が残らない
function callApiExample() {
  const apiKey = getApiKey();
  const res = UrlFetchApp.fetch("https://api.example.com/v1/messages", {
    method: "post",
    headers: { "x-api-key": apiKey },
    muteHttpExceptions: true,
  });
  Logger.log(res.getResponseCode());
}

// 一度だけ実行して設定値をまとめて登録する
// （APIキーのような機密値は「プロジェクトの設定」画面から
//   手入力するほうが、コードに値が残らず安全）
function setupProperties() {
  const props = PropertiesService.getScriptProperties();
  props.setProperties({
    SLACK_WEBHOOK_URL: "https://hooks.slack.com/services/xxx/yyy/zzz",
    SPREADSHEET_ID: "1AbcDefGhijkLmnOpqrStuvWxyz",
    NOTIFY_HOUR: "9",
  });
  Logger.log("設定値を登録しました");
}

// 登録済みの全キーを確認する
function showAllProperties() {
  const props = PropertiesService.getScriptProperties();
  Logger.log(JSON.stringify(props.getProperties(), null, 2));
}

// スクリプトプロパティ: スクリプト全体で共通。誰が実行しても同じ
const scriptProps = PropertiesService.getScriptProperties();

// ユーザープロパティ: 実行したユーザーごとに別々。本人にしか見えない
const userProps = PropertiesService.getUserProperties();

// ドキュメントプロパティ: 紐づいたシート/ドキュメント単位で保存
const docProps = PropertiesService.getDocumentProperties();

// 例: 個人ごとの通知先はユーザープロパティに保存する
function saveMyNotifyEmail(email) {
  PropertiesService.getUserProperties()
    .setProperty("MY_NOTIFY_EMAIL", email);
}

function getMyNotifyEmail() {
  return PropertiesService.getUserProperties()
    .getProperty("MY_NOTIFY_EMAIL");
}

const DEFAULT_CONFIG = {
  notifyHour: 9,
  batchSize: 20,
  enableSlack: true,
  targetSheet: "受付データ",
};

// 設定をJSONでまとめて保存・取得する
function saveConfig(config) {
  PropertiesService.getScriptProperties()
    .setProperty("APP_CONFIG", JSON.stringify(config));
}

function loadConfig() {
  const raw = PropertiesService.getScriptProperties()
    .getProperty("APP_CONFIG");

  // 未設定なら初期値、あれば初期値に上書きマージ
  if (!raw) return { ...DEFAULT_CONFIG };
  return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
}

// 使用例: 足りない項目は初期値で補われる
function job() {
  const config = loadConfig();
  Logger.log(config.batchSize); // 未保存でも 20 が返る
}

// 「設定」シートのA列=キー / B列=値 を
// スクリプトプロパティに反映する。非エンジニアでも編集しやすい
function syncConfigFromSheet() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("設定");
  const rows = sheet.getDataRange().getValues().slice(1); // ヘッダー除く

  const map = {};
  rows.forEach(([key, value]) => {
    if (key) map[String(key).trim()] = String(value);
  });

  PropertiesService.getScriptProperties().setProperties(map, true);
  Logger.log(Object.keys(map).length + " 件の設定を反映しました");
}

// Before: キーがコードに直書きされている（危険）
function badExample() {
  const apiKey = "sk-ant-xxxxxxxxxxxxxxxx"; // 共有すると漏れる
  // ...
}

// After: PropertiesServiceから取得する
function goodExample() {
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  if (!apiKey) throw new Error("APIキーが未設定です");
  // ...
}

// 不要になった値を削除する
function deleteOldKey() {
  PropertiesService.getScriptProperties().deleteProperty("OLD_TOKEN");
}