Gmail の添付ファイル。これは通常の Blob
です。ただし、getBytes()
.length
の呼び出しよりも高速な getSize()
メソッドが追加で、Gmail の読み取り割り当てにカウントされません。
// Logs information about any attachments in the first 100 inbox threads. 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()); } } }
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
copyBlob() | Blob | この blob のコピーを返します。 |
getAs(contentType) | Blob | このオブジェクト内のデータを、指定されたコンテンツ タイプに変換された blob として返します。 |
getBytes() | Byte[] | この blob に保存されているデータを取得します。 |
getContentType() | String | この blob 内のバイトのコンテンツ タイプを取得します。 |
getDataAsString() | String | この blob のデータを UTF-8 エンコードの文字列として取得します。 |
getDataAsString(charset) | String | この blob のデータを、指定されたエンコードで文字列として取得します。 |
getHash() | String | この添付ファイルの SHA1 コンテンツ ハッシュを取得します。 |
getName() | String | この blob の名前を取得します。 |
getSize() | Integer | このアタッチメントのサイズを取得します。 |
isGoogleType() | Boolean | この blob が Google Workspace ファイル(スプレッドシート、ドキュメントなど)かどうかを返します。 |
setBytes(data) | Blob | この blob に格納されているデータを設定します。 |
setContentType(contentType) | Blob | この blob 内のバイトのコンテンツ タイプを設定します。 |
setContentTypeFromExtension() | Blob | ファイル拡張子に基づいて、この blob 内のバイトのコンテンツ タイプを設定します。 |
setDataFromString(string) | Blob | UTF-8 エンコードの文字列からこの blob のデータを設定します。 |
setDataFromString(string, charset) | Blob | 指定されたエンコードを使用して、文字列からこの blob のデータを設定します。 |
setName(name) | Blob | この blob の名前を設定します。 |
詳細なドキュメント
copyBlob()
getAs(contentType)
このオブジェクト内のデータを、指定されたコンテンツ タイプに変換された blob として返します。この方法では、ファイル名に適切な拡張子(「myfile.pdf」など)が追加されます。ただし、ファイル名の最後のピリオド(存在する場合)に続く部分は、置き換えられる既存の拡張子であることを前提としています。この結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。
コンバージョンの 1 日あたりの割り当てを確認するには、Google サービスの割り当てをご覧ください。新しく作成された Google Workspace ドメインには、一時的に割り当てが厳しくなることがあります。
パラメータ
名前 | 型 | 説明 |
---|---|---|
contentType | String | 変換先の MIME タイプ。ほとんどの blob では、有効なオプションは 'application/pdf' のみです。BMP、GIF、JPEG、PNG 形式の画像の場合は、'image/bmp' 、'image/gif' 、'image/jpeg' 、'image/png' のいずれかも有効です。 |
リターン
Blob
- blob としてのデータ。
getBytes()
この blob に保存されているデータを取得します。
リターン
Byte[]
- 保存されたバイト数。
getContentType()
この blob 内のバイトのコンテンツ タイプを取得します。
リターン
String
- このデータのコンテンツ タイプ(判明している場合)。または null
。
getDataAsString()
この blob のデータを UTF-8 エンコードの文字列として取得します。
リターン
String
- データ(文字列)。
getDataAsString(charset)
この blob のデータを、指定されたエンコードで文字列として取得します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
charset | String | この blob のデータを文字列としてエンコードする際に使用する文字セット。 |
リターン
String
- データ(文字列)。
getHash()
この添付ファイルの SHA1 コンテンツ ハッシュを取得します。このメソッドは、Gmail の読み取り割り当てにはカウントされません。
リターン
String
- SHA1 コンテンツ ハッシュ(文字列)。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープ、または関連する REST API の適切なスコープによる承認が必要です。
-
https://mail.google.com/
getName()
この blob の名前を取得します。
リターン
String
- このデータの名前(わかっている場合)または null
。
getSize()
このアタッチメントのサイズを取得します。このメソッドは、getBytes()
.length
を呼び出すよりも高速であり、Gmail の読み取り割り当てにはカウントされません。
リターン
Integer
- アタッチメントのサイズ(バイト単位)。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープ、または関連する REST API の適切なスコープによる承認が必要です。
-
https://mail.google.com/
isGoogleType()
この blob が Google Workspace ファイル(スプレッドシート、ドキュメントなど)かどうかを返します。
リターン
Boolean
- この blob が Google Workspace ファイルの場合は true
、そうでない場合は false
。
setBytes(data)
setContentType(contentType)
この blob 内のバイトのコンテンツ タイプを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
contentType | String | 新しい contentType。 |
リターン
Blob
- チェーン用のこの blob。
setContentTypeFromExtension()
ファイル拡張子に基づいて、この blob 内のバイトのコンテンツ タイプを設定します。拡張子から推測できない場合、contentType は null
になります。
リターン
Blob
- チェーン用のこの blob。
setDataFromString(string)
setDataFromString(string, charset)
指定されたエンコードを使用して、文字列からこの blob のデータを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
string | String | 文字列データ。 |
charset | String | 文字列をバイトとして解釈する際に使用する文字セット。 |
リターン
Blob
- チェーン用のこの blob。