Class Blob

Blob

A data interchange object for Apps Script services.

Methods

Method Return type Brief description
Blob Returns a copy of this blob.
Blob Return the data inside this object as a blob converted to the specified content type.
Byte[] Gets the data stored in this blob.
String Gets the content type of the bytes in this blob.
String Gets the data of this blob as a String with UTF-8 encoding.
String Gets the data of this blob as a string with the specified encoding.
String Gets the name of this blob.
Boolean Returns whether this blob is a Google Workspace file (Sheets, Docs, etc.).
Blob Sets the data stored in this blob.
Blob Sets the content type of the bytes in this blob.
Blob Sets the content type of the bytes in this blob based on the file extension.
Blob Sets the data of this blob from a string with UTF-8 encoding.
Blob Sets the data of this blob from a string with the specified encoding.
Blob Sets the name of this blob.

Detailed documentation

copyBlob()

Returns a copy of this blob.

Return

Blob — The new copy.


getAs(contentType)

Return the data inside this object as a blob converted to the specified content type. This method adds the appropriate extension to the filename—for example, "myfile.pdf". However, it assumes that the part of the filename that follows the last period (if any) is an existing extension that should be replaced. Consequently, "ShoppingList.12.25.2014" becomes "ShoppingList.12.25.pdf".

To view the daily quotas for conversions, see Quotas for Google Services . Newly created Google Workspace domains might be temporarily subject to stricter quotas.

Parameters

Name Type Description
contentType
String The MIME type to convert to. For most blobs, 'application/pdf' is the only valid option. For images in BMP, GIF, JPEG, or PNG format, any of 'image/bmp' , 'image/gif' , 'image/jpeg' , or 'image/png' are also valid. For a Google Docs document, 'text/markdown' is also valid.

Return

Blob — The data as a blob.


getBytes()

Gets the data stored in this blob.

Return

Byte[] — The stored bytes.


getContentType()

Gets the content type of the bytes in this blob.

Return

String — The content type of this data, if known, or null .


getDataAsString()

Gets the data of this blob as a String with UTF-8 encoding.

Return

String — The data as a string.


getDataAsString(charset)

Gets the data of this blob as a string with the specified encoding.

Parameters

Name Type Description
charset
String The charset to use in encoding the data in this blob as a string.

Return

String — The data as a string.


getName()

Gets the name of this blob.

Return

String — The name of this data, if known, or null .


isGoogleType()

Returns whether this blob is a Google Workspace file (Sheets, Docs, etc.).

Return

Boolean true if this blob is a Google Workspace file; false if not.


setBytes(data)

Sets the data stored in this blob.

Parameters

Name Type Description
data
Byte[] The new data.

Return

Blob — This blob, for chaining.


setContentType(contentType)

Sets the content type of the bytes in this blob.

Parameters

Name Type Description
contentType
String The new contentType.

Return

Blob — This blob, for chaining.


setContentTypeFromExtension()

Sets the content type of the bytes in this blob based on the file extension. The contentType is null if it cannot be guessed from its extension.

Return

Blob — This blob, for chaining.


setDataFromString(string)

Sets the data of this blob from a string with UTF-8 encoding.

Parameters

Name Type Description
string
String The string data.

Return

Blob — This blob, for chaining.


setDataFromString(string, charset)

Sets the data of this blob from a string with the specified encoding.

Parameters

Name Type Description
string
String The string data.
charset
String The charset to use in interpreting the string as bytes.

Return

Blob — This blob, for chaining.


setName(name)

Sets the name of this blob.

Parameters

Name Type Description
name
String The new name.

Return

Blob — This blob, for chaining.

Deprecated methods