GASでスプレッドシートの
セルに画像を挿入する方法

function insertImageFromUrl() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");
  const url = "https://example.com/images/item01.png";

  // insertImage(URL, 列番号, 行番号) → 第2引数=列, 第3引数=行
  // この例ではB2セルの左上に画像を配置する
  const image = sheet.insertImage(url, 2, 2);

  // 表示サイズをピクセルで指定
  image.setWidth(120).setHeight(120);
}

function insertImageFromDrive() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");

  // Googleドライブ上のファイルをBlob（バイナリデータの入れ物）として取得
  const file = DriveApp.getFilesByName("item01.png").next();
  const blob = file.getBlob();

  // URLの代わりにBlobを渡すと、共有設定に依存せず確実に貼り付けられる
  sheet.insertImage(blob, 2, 2);
}

function setCellImage() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");
  const url = "https://example.com/images/item01.png";

  // newCellImage() で「セルの中身」になる画像を組み立てる
  const cellImage = SpreadsheetApp.newCellImage()
    .setSourceUrl(url)
    .setAltTextTitle("商品サムネイル") // 読み上げ・代替テキスト
    .build();

  // setValue で通常の値と同じようにセルへ入れる（並べ替えに追従する）
  sheet.getRange("B2").setValue(cellImage);
}

function setImageFormula() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");
  const url = "https://example.com/images/item01.png";

  // =IMAGE(URL, モード, 高さ, 幅)
  // モード4 = 高さ・幅をピクセルで指定する
  sheet.getRange("B2").setFormula('=IMAGE("' + url + '", 4, 80, 80)');
}

function placeImageOnCell() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");
  const url = "https://example.com/images/logo.png";

  // いったんA1に挿入
  const image = sheet.insertImage(url, 1, 1);

  // 基準セルを変更（D3の位置へ移動）
  image.setAnchorCell(sheet.getRange("D3"));

  // 基準セルからのズレ（ピクセル）で微調整
  image.setAnchorCellXOffset(5);
  image.setAnchorCellYOffset(5);

  image.setWidth(200).setHeight(60);
}

function insertImagesFromList() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  // A列=商品名, B列=画像URL, C列に画像を入れる想定（2行目から）
  const urls = sheet.getRange(2, 2, lastRow - 1, 1).getValues();

  urls.forEach((row, i) => {
    const url = String(row[0]).trim();
    if (!url) return; // 空欄はスキップ

    const rowNumber = i + 2; // ヘッダー分+1
    const cellImage = SpreadsheetApp.newCellImage()
      .setSourceUrl(url)
      .build();

    sheet.getRange(rowNumber, 3).setValue(cellImage); // C列に配置
  });
}

function removeAllOverGridImages() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("商品");

  // セルの上に「浮いている」画像をすべて取得
  const images = sheet.getImages();
  Logger.log("削除対象の画像数: " + images.length);

  images.forEach((image) => image.remove());
}