GASでスプレッドシートに画像を挿入する方法(insertImage)

2022年1月11日

スプレッドシートでは写真やイラストなどの画像ファイルを追加し、シート上に表示することができます。

今回、Google Apps Script(GAS)でシートに画像を挿入する方法を解説します。

1. スプレッドシートは画像も表示可能
2. GASでもシートに画像挿入を実行
3. シートに画像挿入するinsertImageメソッド
4. シートに画像挿入するGASサンプルコード
5. 行や列の幅が異なる場合の画像挿入位置は？
6. まとめ・終わりに

スプレッドシートは画像も表示可能

スプレッドシートはGoogleが提供する表計算のアプリケーションです。

主に売上表や在庫表などの数値管理にスプレッドシートは活用されています。

しかし、スプレッドシートには、数値だけでなく、画像も挿入することができます。

スプレッドシートのシート上に画像を表示することで、マニュアルとしてシートの利用が可能になります。

GASでもシートに画像挿入を実行

シートへの画像挿入は、通常Chromeなどのブラウザを使いスプレッドシートのGUIで行います。

自動化のスクリプトサービスであるGoogle Apps Script(GAS)では、スプレッドシートの各種操作がプログラム実行可能です。

スプレッドシートに画像を挿入することもGASで実行することができます。

シートに画像挿入するinsertImageメソッド

Google Apps Script(GAS)でスプレッドシート内の特定のシートに画像を挿入するには、insertImageメソッドを利用します。

sheet.insertImage('blob形式画像’, '列番号’, '行番号’)

insertImageメソッドは、画像を挿入したいシートオブジェクトで実行します。

insertImageメソッドには3つの引数が必要です。

1つ目はシートに挿入する画像で、blob形式のものを指定します。

2つ目の引数に列番号、3つ目の引数に行番号を指定することで、画像をシート上のどこに配置するか決めることができます。

注意したいのは、GASで行と列の引数の順番は「行番号→列番号」の並びが多いですが、insertImageでは「列番号→行番号」である点です。

例えば、GASスクリプトでsheet.insertImage(image, 5, 10)を実行すると、E10セルの位置に画像が挿入されます。

シートに画像挿入するGASサンプルコード

スプレッドシートのシートに画像を挿入するGoogle Apps Script(GAS)のサンプルコードを紹介します。

今回、このブログのファビコンに設定しているこちらの画像をGASでスプレッドシートに挿入します。

先程紹介したinsertImageメソッドを使ったGASサンプルコードは以下の通りです。

Google Apps Script(GAS)のinsertImageメソッドを使ったスプレッドシートのシートに画像挿入するサンプルコード

function insertImageToSheet() {
  //スクリプトに紐づくスプレッドシートのアクティブなシートを取得
  let mySheet = SpreadsheetApp.getActiveSheet();
  //画像のURLからblob形式で画像を取得
  let image = UrlFetchApp.fetch("https://auto-worker.com/img/brand.png").getBlob();
  //取得した画像をアクティブなシートに挿入
  mySheet.insertImage(image, 5, 10);
}

先程の画像をUrlFetchAppクラスのfetchメソッドで取得し、Blob形式で保存します。

その後、アクティブなシートに対し、insertImageでE10セルの位置に画像を挿入します。

画像挿入のGASサンプルコードを実行すると、スプレッドシートのシート上に画像が表示されます。