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

Class Blob

Apps Script サービス用のデータ交換オブジェクト。

Methods

メソッド	戻り値の型	概要
`copyBlob()`	`Blob`	この blob のコピーを返します。
`getAs(contentType)`	`Blob`	このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。
`getBytes()`	`Byte[]`	この blob に保存されているデータを取得します。
`getContentType()`	`String`	この blob 内のバイトのコンテンツタイプを取得します。
`getDataAsString()`	`String`	この blob のデータを UTF-8 エンコードの文字列として取得します。
`getDataAsString(charset)`	`String`	この blob のデータを、指定されたエンコードで文字列として取得します。
`getName()`	`String`	この blob の名前を取得します。
`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 サービスの割り当てをご覧ください。新しく作成された 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 - データ（文字列）。

`getName()`

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

リターン

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

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