このページは Cloud Translation API によって翻訳されました。

Class GmailAttachment

Gmail の添付ファイル。これは通常の Blob ですが、呼び出すよりも高速な追加の getSize() メソッドがある点が異なります getBytes().length で、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());
    }
  }
}

メソッド

メソッド	戻り値の型	概要
`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 の名前を設定します。

サポート終了のメソッド

メソッド	戻り値の型	概要
`getAllBlobs()`	`Blob[]`	この（複合の）blob に含まれているすべての blob を取得します。

詳細なドキュメント

`copyBlob()`

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

戻る

Blob - 新しいコピー。

`getAs(contentType)`

このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。このメソッドにより、ファイル名に適切な拡張子（例: myfile.pdf）が追加されます。ただし、ファイル名の最後のピリオド（ある場合）に続く部分は、指定します。したがって、「ShoppingList.12.25.2014」となります。が以下に変換される: 「ShoppingList.12.25.pdf」

コンバージョンの 1 日あたりの割り当てを確認するには、Google Cloud の割り当てサービス。新しく作成された Google Workspace ドメインには一時的に厳格なできます。

パラメータ

名前	型	説明
`contentType`	`String`	変換先の MIME タイプ。ほとんどの blob の場合、`'application/pdf'` は次のようになります。唯一の有効な選択肢となりますBMP、GIF、JPEG、PNG 形式の画像の場合は、`'image/bmp'`、`'image/gif'`、`'image/jpeg'`、`'image/png'` のいずれかも可有効です。Google ドキュメントのドキュメントの場合は、`'text/markdown'` も有効です。

戻る

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)`

この blob に格納されるデータを設定します。

パラメータ

名前	型	説明
`data`	`Byte[]`	新しいデータ。

戻る

Blob - チェーン用のこの blob。

`setContentType(contentType)`

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

パラメータ

名前	型	説明
`contentType`	`String`	新しい contentType。

戻る

Blob - チェーン用のこの blob。

`setContentTypeFromExtension()`

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

戻る

Blob - チェーン用のこの blob。

`setDataFromString(string)`

UTF-8 でエンコードされた文字列から、この blob のデータを設定します。

パラメータ

名前	型	説明
`string`	`String`	文字列データ。

戻る

Blob - チェーン用のこの blob。

`setDataFromString(string, charset)`

指定されたエンコードの文字列から、この blob のデータを設定します。

パラメータ

名前	型	説明
`string`	`String`	文字列データ。
`charset`	`String`	文字列をバイトとして解釈する際に使用する文字セット。

戻る

Blob - チェーン用のこの blob。

`setName(name)`

この blob の名前を設定します。

パラメータ

名前	型	説明
`name`	`String`	新しい名前です。

戻る

Blob - チェーン用のこの blob。

サポート終了のメソッド

`getAllBlobs()`

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この（複合の）blob に含まれているすべての blob を取得します。

戻る

Blob[] - blob に含まれる blob。