Googleスライドに配置した画像を枠として使い、Drive内の画像へまとめて差し替える方法です。
今回は1スライドに1~20枚を配置する練習例とし、テンプレートを別ファイルへ複製してから、そのコピーだけを編集します。
配置はテンプレートで決めます。
旧コードのDrive.Children.listや一時的なサムネイルURLを使わず、標準のDriveAppとSlidesAppで画像データを読み取ります。
拡張Drive APIやGoogle Slides APIのサービス追加は不要です。
画像とテンプレートを用意する
画像フォルダの直下にPNG・JPEG・GIFを入れ、01_写真.png、02_写真.jpgのように2桁番号とアンダースコアで始まる名前にします。
01から欠番なく連番にし、同じ番号を2枚に使わないでください。
子フォルダ内、ショートカット、SVG、WebPなどは対象外です。
テンプレートのGoogleスライドは1ページにし、入力画像と同じ枚数の仮画像を挿入して好きな位置・大きさに配置します。
普通の図形やテキスト枠ではなく画像を使い、画像同士をグループ化しないでください。
装飾用の別画像も枚数に含まれるため、この練習では差し替える画像だけを置きます。
各仮画像の代替テキストの「タイトル」をslot-01、slot-02のように設定します。
画像ファイルの番号と対応させ、説明欄とは取り違えないでください。
文字枠などは残りますが、画像のマスク・回転・複雑な重なりの再現は実際の出力で確認します。
まず四角い画像枠2個から試してください。
GASの設定とコード
新規Apps Scriptプロジェクトに下のコードを保存します。
IMAGE_FOLDER_IDは画像フォルダ、TEMPLATE_IDはテンプレートのプレゼンテーション、OUTPUT_FOLDER_IDは保存先フォルダのIDです。
フォルダURLの「/folders/」以降、プレゼンテーションURLの「/d/」と「/edit」の間からIDだけを指定し、OUTPUT_NAMEには未使用の結果名を設定します。
function imageSlots_(deck, count) {
const slides = deck.getSlides();
if (slides.length !== 1) throw new Error('テンプレートは1スライドにしてください');
const images = slides[0].getImages();
if (images.length !== count) throw new Error('画像枠と入力画像の枚数が一致しません');
const slots = new Map();
for (const image of images) {
const title = image.getTitle();
if (slots.has(title)) throw new Error('画像枠のタイトルが重複しています');
slots.set(title, image);
}
return Array.from({length: count}, (_, i) => {
const key = 'slot-' + String(i + 1).padStart(2, '0');
if (!slots.has(key)) throw new Error('画像枠のタイトルがありません: ' + key);
return slots.get(key);
});
}
function insertPracticeImages() {
const IMAGE_FOLDER_ID = '画像フォルダID';
const TEMPLATE_ID = '1スライドのテンプレートID';
const OUTPUT_FOLDER_ID = '出力先フォルダID';
const OUTPUT_NAME = '練習_画像配置';
const lock = LockService.getScriptLock();
if (!lock.tryLock(5000)) throw new Error('同じプロジェクトで実行中です');
try {
const folder = DriveApp.getFolderById(IMAGE_FOLDER_ID);
const iterator = folder.getFiles(), numbered = new Map();
let scanned = 0;
while (iterator.hasNext()) {
const file = iterator.next();
if (++scanned > 100) throw new Error('直下100ファイル以内で試してください');
if (file.isTrashed()) continue;
if (!['image/png', 'image/jpeg', 'image/gif'].includes(file.getMimeType())) continue;
const match = /^(\d{2})_/.exec(file.getName());
if (!match || Number(match[1]) < 1 || Number(match[1]) > 20) throw new Error('画像名は01_から20_の番号で始めてください');
const n = Number(match[1]);
if (numbered.has(n)) throw new Error('画像番号が重複しています');
if (file.getSize() > 5 * 1024 * 1024) throw new Error('練習例は画像1枚5MiB以下です');
numbered.set(n, file);
}
const count = numbered.size;
if (!count) throw new Error('対象画像がありません');
const files = Array.from({length: count}, (_, i) => {
if (!numbered.has(i + 1)) throw new Error('画像番号を01から連番にしてください');
return numbered.get(i + 1);
});
imageSlots_(SlidesApp.openById(TEMPLATE_ID), count);
const output = DriveApp.getFolderById(OUTPUT_FOLDER_ID);
if (output.getFilesByName(OUTPUT_NAME).hasNext()) throw new Error('同名の出力があります。先に結果を確認してください');
const copy = DriveApp.getFileById(TEMPLATE_ID).makeCopy(OUTPUT_NAME, output);
console.log('作成したプレゼンテーションID: ' + copy.getId());
const deck = SlidesApp.openById(copy.getId());
const slots = imageSlots_(deck, count);
for (let i = 0; i < count; i++) {
slots[i].replace(files[i].getBlob(), true).setTitle(files[i].getName()).setDescription('');
}
deck.saveAndClose();
console.log('更新完了: ' + copy.getUrl());
} finally {
lock.releaseLock();
}
}
insertPracticeImagesを手動実行し、初回はDriveとSlidesへの権限を確認して認可します。
更新完了のログに出るURLを開き、01の画像がslot-01の位置に入っているか、全画像の順番・枚数・表示を確認してください。
元のテンプレートと画像ファイルは変更しません。
出力先フォルダの共有範囲も事前に確認します。
画像の切り抜きと制限
replaceの第2引数trueは、元の画像枠を満たすようにトリミングします。
縦横比が違えば画像の一部が見えなくなります。
画像全体を収めたい場合はfalseに変更できますが、その場合は枠を埋める配置とは異なるため、余白と位置を確認してください。
Googleの公式仕様ではPNG・JPEG・GIF、50MB未満、25メガピクセル以下が条件です。
本例はさらに小さく1枚5MiB以下、1~20枚、フォルダ直下100ファイル以内に制限しています。
画素数や壊れた画像は事前判定していないため、条件を超える画像や内容不備では差し替え時に失敗する場合があります。
差し替え後の代替テキストのタイトルには画像ファイル名を設定し、旧説明を空にします。
資料の配布前に、画像の内容を適切に説明する代替テキストへ整えてください。
失敗・再実行時に確認すること
画像番号の重複・欠番、枠タイトルの重複・不足、枚数の不一致はコピー作成前に停止します。
出力先にOUTPUT_NAMEと同じ名前のファイルがある場合も停止します。
ただし結果を改名・移動した場合や別の名前で再実行した場合は、再びコピーが作られます。
コピー後に差し替えが失敗すると、途中まで更新されたファイルが残る場合があります。
エラーは握りつぶさず停止します。
ログの作成IDと出力先を確認し、完成品と混同しないでください。
通信エラーでも作成済みの可能性があるため、結果を見ずに再送しないでください。
同じプロジェクトの同時実行はロックしますが、別プロジェクトや他の人の編集は防げません。
実行中は元画像・テンプレート・出力先を変更しない状態で試します。
定期トリガーやWebアプリのデプロイは不要です。
検証範囲と公式資料
2026年10月23日に本文とコードを改訂しました。
ローカル模擬環境で番号順の対応、枠の重複/不足、入力不備、出力同名停止、途中失敗とロック解放を確認しました。
Googleでの認可・実際の画像差し替え・トリミング・マスク・画面表示は未確認です。
Slides Imageのreplace・getTitle・画像条件が公式仕様です。
旧コードはGitHubのMOTOKI-LLC/cg-method-codeにもありますが、改訂コードと同じ版とは限りません。
このページのコードを使用してください。
旧実装の参考画像
以下のBEFORE・AFTERや設定画面は旧実装の参考です。
今回の番号付き画像枠の実行結果や、現行画面の確認証跡ではありません。
サービス追加が写っていても、改訂コードでは不要です。








関連するGoogleスライドの操作




