GASでBlob形式の画像をBase64にエンコードする方法(デコード手順も)

2023年12月28日

Google Apps Script(GAS)では画像ファイルはBlob形式で扱うことが多いです。

ただ、外部のAPI利用時に画像をBase64形式に変換するエンコードが必要になることがあります。

そこでGASでBlob形式の画像ファイルを、Utilities.base64Encodeメソッドを使ってBase64形式に変換する方法を解説します。

1. GASは通常Blob形式で画像を扱う
2. Base64形式とは
3. APIなどでもBase64エンコードが必要
4. Base64にエンコードするUtilities.base64Encode
5. 画像をBase64にエンコードするGASサンプルコード
6. Base64のデータをデコードするには？
7. まとめ・終わりに

GASは通常Blob形式で画像を扱う

Google Apps Script(GAS)では、Googleドライブなどから画像ファイルを読み込む場合、Blobオブジェクトで画像を扱います。

Google Apps Scriptで画像を扱う場合はBlobオブジェクトとして処理することが多い

BlobオブジェクトはGASで利用可能な各種サービス間でデータをやり取りするためのフォーマットです。

Gmailのメールに画像を添付したり、Googleスライドに画像を挿入する際に、Blob形式にしておくことが求められます。

Base64形式とは

Base64は64進数を意味しており、画像などのファイルをアルファベットの小文字+大文字、数字の0-9、一部記号の64文字で表現するエンコード方法です。

メール送付のプロトコルであるSMTPは英数字しか扱えなかったため、画像をそのまま送付できませんでした。

そこで、画像を英数字・記号で表現するBase64にエンコードすることで添付ファイルとして送付可能になりました。

このようにBase64はバイナリデータをテキスト形式でしか扱えない場合に利用し、Base64エンコードしてから送信し、受信側はBase64をデコードして画像などのファイルを受け取ります。

※画像以外だとURLもBase64にエンコード・デコードすることがあります。

APIなどでもBase64エンコードが必要

Google Apps script(GAS)では、Google系サービスで画像をやり取りする場合は、Blob形式を利用します。

GASのスクリプトエディタで追加できるサービスもBlob形式でファイルをやり取りすることが多いです。

画像やPDFなどをGoogle Apps script(GAS)で扱う際に利用するBlobクラスのリファレンス

ただ、GAS標準のGoogleサービス以外、外部のAPIに画像を送りたい場合、Base64形式にエンコードが必要となります。

例えば、生成AIのGemini APIではマルチモーダルによる画像の入力ができます。

Gemini APIで画像をAPIリクエストする際にBase64形式でなければなりません。

以上のように別サービスのAPIを利用する際に、Base64形式に変換が必要となるケースが出てきます。

Base64にエンコードするUtilities.base64Encode

Base64にエンコードするには、Google Apps script(GAS)のUtilitiesクラスに用意されたbase64Encodeメソッドを利用します。

ただ、GASでBlobオブジェクトの画像をUtilities.base64Encodeの引数に指定しても、エラーします。

なぜならば、Utilities.base64Encodeの引数にはByte型オブジェクトが指定されているからです。

Google Apps script(GAS9で画像などをBase64にエンコードするにはByte配列に変換したものをUtilities.base64Encodeメソッドの引数に指定

そのため、Blob形式の画像でgetByte()メソッドを実行して、Byte型オブジェクトに変換した上でUtilities.base64Encodeを実行し、Base64形式にエンコードします。

画像をBase64にエンコードするGASサンプルコード

実際にGoogle Apps script(GAS)で画像ファイルをBase64にエンコードするサンプルコードを解説します。

function encodeImage(){
  //Googleドライブにある画像ファイルを読み込んでBlobオブジェクトで取得
  const image = DriveApp.getFileById("Googleドライブの画像ファイルID").getBlob();
  //BlobオブジェクトからByteを取得してBase64にエンコード
  const baseImage = Utilities.base64Encode(image.getBytes());
  //Base64エンコードした結果をログ出力
  console.log(baseImage);
}