【GAS】Ｇメールの添付機能まとめ【サンプルソース付】

GAS開発者向けにＧメールの添付機能をすべてまとめました。

あらかじめ準備しておいて、簡単に手早く添付できるようにしましょう。

添付に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Ｇメールメッセージクラス[GmailMessage]の添付取得

Ｇメールのメッセージ添付取得メソッドです。

すべての添付ファイル取得1[getAttachments()]

getAttachments()
このメッセージのすべての添付ファイルを取得します。

Return
GmailAttachment[] - このメッセージのBlob添付ファイルの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | getAttachments()

すべての添付ファイル取得2[getAttachments(オプション's)]

getAttachments(options)
このメッセージのすべての添付ファイルを取得します。

Return
GmailAttachment[] - このメッセージのBlob添付ファイルの配列。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | getAttachments(options)

Ｇメール添付クラス[GmailAttachment]

Gmailからの添付ファイル。これは通常のBlobですが、追加のgetSize()メソッドがあり、getBytes()。lengthを呼び出すよりも高速で、Gmailの読み取り割り当てにカウントされません。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailAttachment

function gmailAttachmentSample() {
  // 最初の100個の受信トレイスレッドの添付ファイルに関する情報を記録します。
  var threads = GmailApp.getInboxThreads(0, 100);
  var msgs = GmailApp.getMessagesForThreads(threads);
  for (var i = 0 ; i < msgs.length; i++) {
    for (var j = 0; j < msgs[i].length; j++) {
      var attachments = msgs[i][j].getAttachments();
      for (var k = 0; k < attachments.length; k++) {
        Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
        msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
      }
    }
  }
}

添付コピー[copyBlob()]

copyBlob()
このblobのコピーを返します。

Return
Blob - 新しいコピー。

添付変換取得[getAs(コンテンツタイプ)]

getAs(contentType)
このオブジェクト内のデータを、指定されたコンテンツタイプに変換されたblobとして返します。このメソッドは、ファイル名に適切な拡張子を追加します（たとえば、「myfile.pdf」）。ただし、最後のピリオド（存在する場合）に続くファイル名の部分は、置き換える必要がある既存の拡張子であると想定されます。その結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

Return
Blob - ブロブとしてのデータ。

添付データ取得[getBytes()]

getBytes()
このblobに保存されているデータを取得します。

Return
Byte[] - 格納されたバイト。

添付コンテンツタイプ取得[getContentType()]

getContentType()
このblobのバイトのコンテンツタイプを取得します。

Return
String - このデータのコンテンツタイプ（既知の場合）、またはnull。

添付UTF-8文字列データ取得[getDataAsString()]

getDataAsString()
このblobのデータをUTF-8エンコーディングの文字列として取得します。

Return
String - 文字列としてのデータ。

添付指定文字列データ取得[getDataAsString(文字コード)]

getDataAsString(charset)
このblobのデータを、指定されたエンコーディングの文字列として取得します。

Return
String - 文字列としてのデータ。

添付ハッシュ取得[getHash()]

getHash()
この添付ファイルのSHA1コンテンツハッシュを取得します。この方法は、Gmailの読み取りクォータにはカウントされません。

Return
String - 文字列としてのSHA1コンテンツハッシュ。

添付名取得[getName()]

getName()
このblobの名前を取得します。

Return
String - このデータの名前（わかっている場合）、またはnull。

添付ファイルサイズ取得[getSize()]

getSize()
この添付ファイルのサイズを取得します。このメソッドは、getBytes（）。lengthを呼び出すよりも高速で、Gmailの読み取りクォータにはカウントされません。

Return
Integer - 添付ファイルのサイズ（バイト単位）。

添付ファイルG Suite確認[isGoogleType()]

isGoogleType()
このblobがG Suiteファイル（シート、ドキュメントなど）かどうかを返します。

Return
Boolean - このblobがG Suiteファイルの場合はtrue。そうでない場合はfalse。

添付保存データ設定[setBytes(データ)]

setBytes(data)
このblobに保存されているデータを設定します。

Return
Blob - 連鎖用のBlob。

添付コンテンツタイプ設定[setContentType(コンテンツタイプ)]

setContentType(contentType)
このblobのバイトのコンテンツタイプを設定します。

Return
Blob - 連鎖用のBlob。

添付コンテンツタイプ拡張子設定[setContentTypeFromExtension()]

setContentTypeFromExtension()
ファイル拡張子に基づいて、このblobのバイトのコンテンツタイプを設定します。 contentTypeは、拡張子から推測できない場合はnullです。

Return
Blob - 連鎖用のBlob。

添付UTF-8文字列データ設定[setDataFromString(文字列]

setDataFromString(string)
UTF-8エンコーディングで文字列からこのblobのデータを設定します。

Return
Blob - 連鎖用のBlob。

添付指定文字列データ設定[setDataFromString(文字列, 文字コード)]

setDataFromString(string, charset)
指定されたエンコーディングで文字列からこのblobのデータを設定します。

Return
Blob - 連鎖用のBlob。

添付名設定[setName(名前)]

setName(name)
このblobの名前を設定します。

Return
Blob - 連鎖用のBlob。

最後に

Ｇメールの添付機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

caymezon.com

2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。