GASでシートに隠し情報を埋め込む！getDeveloperMetadata活用術

function getAllMetadataFromSpreadsheet() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // スプレッドシート全体のメタデータを配列で取得
  const metadataArray = spreadsheet.getDeveloperMetadata();

  // 取得したメタデータをループ処理で表示
  metadataArray.forEach(meta => {
    console.log(`キー: ${meta.getKey()}, 値: ${meta.getValue()}`);
  });
}

function getMetadataFromSheet() {
  const sheet = SpreadsheetApp.getActive().getSheetByName('注文明細');
  // '注文明細'シートに紐づくメタデータを取得
  const sheetMetadata = sheet.getDeveloperMetadata();

  sheetMetadata.forEach(meta => {
    console.log(`キー: ${meta.getKey()}, 値: ${meta.getValue()}`);
  });
}

function getMetadataFromRange() {
  const sheet = SpreadsheetApp.getActive().getSheetByName('商品リスト');
  const range = sheet.getRange('A2:A10'); // 商品IDが設定されている範囲
  // 指定範囲に紐づくメタデータを取得
  const rangeMetadata = range.getDeveloperMetadata();

  rangeMetadata.forEach(meta => {
    // メタデータが紐づくセルの行番号を取得
    const row = meta.getLocation().getRow();
    console.log(`${row}行目の商品ID: ${meta.getValue()}`);
  });
}

function findSpecificMetadata() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // ファインダーを作成し、検索条件を指定
  const finder = spreadsheet.createDeveloperMetadataFinder()
    .withKey('customer_id') // キーが 'customer_id' のものを探す
    .find(); // 条件に合うメタデータを取得

  finder.forEach(meta => {
    const row = meta.getLocation().getRow();
    console.log(`${row}行目で見つかりました: Key=${meta.getKey()}, Value=${meta.getValue()}`);
  });
}

// 【安全な保存方法】機密情報をPROJECTの可視性で保存する例
function saveSecretKey() {
  const range = SpreadsheetApp.getActiveRange();
  range.addDeveloperMetadata(
    'api_key', 
    'sk_live_xxxxxxxxxx', // ここに実際のAPIキー
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT
  );
}

function getCachedMetadata(key) {
  const cache = CacheService.getScriptCache();
  const cached = cache.get(key);
  
  if (cached != null) {
    return cached; // キャッシュがあればそれを返す
  }
  
  // キャッシュがなければメタデータを取得
  const finder = SpreadsheetApp.getActiveSpreadsheet()
                  .createDeveloperMetadataFinder().withKey(key).find();
  
  if (finder.length > 0) {
    const value = finder[0].getValue();
    cache.put(key, value, 600); // 10分間キャッシュに保存
    return value;
  }
  return null;
}