Class Blob

Blob (link em inglês)

Um objeto de troca de dados para serviços do Google Apps Script.

Métodos

MétodoTipo de retornoBreve descrição
copyBlob()BlobRetorna uma cópia desse blob.
getAs(contentType)BlobRetorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBytes()Byte[]Recebe os dados armazenados nesse blob.
getContentType()StringRecebe o tipo de conteúdo dos bytes neste blob.
getDataAsString()StringRecebe os dados desse blob como uma string com codificação UTF-8.
getDataAsString(charset)StringRecebe os dados desse blob como uma string com a codificação especificada.
getName()StringRecebe o nome desse blob.
isGoogleType()BooleanRetorna se este blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).
setBytes(data)BlobDefine os dados armazenados neste blob.
setContentType(contentType)BlobDefine o tipo de conteúdo dos bytes neste blob.
setContentTypeFromExtension()BlobDefine o tipo de conteúdo de bytes neste blob com base na extensão do arquivo.
setDataFromString(string)BlobDefine os dados desse blob de uma string com codificação UTF-8.
setDataFromString(string, charset)BlobDefine os dados desse blob de uma string com a codificação especificada.
setName(name)BlobDefine o nome deste blob.

Documentação detalhada

copyBlob()

Retorna uma cópia desse blob.

Retornar

Blob: a nova cópia.


getAs(contentType)

Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, supõe que a parte do nome do arquivo que segue o último período (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para ver as cotas diárias de conversões, consulte Cotas do Google Services. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME para o qual será feita a conversão. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens nos formatos BMP, GIF, JPEG ou PNG, qualquer um dos 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válido.

Retornar

Blob: os dados como um blob.


getBytes()

Recebe os dados armazenados nesse blob.

Retornar

Byte[]: os bytes armazenados.


getContentType()

Recebe o tipo de conteúdo dos bytes neste blob.

Retornar

String: o tipo de conteúdo desses dados, se conhecido ou null.


getDataAsString()

Recebe os dados desse blob como uma string com codificação UTF-8.

Retornar

String: os dados como uma string.


getDataAsString(charset)

Recebe os dados desse blob como uma string com a codificação especificada.

Parâmetros

NomeTipoDescrição
charsetStringO charset a ser usado para codificar os dados nesse blob como uma string.

Retornar

String: os dados como uma string.


getName()

Recebe o nome desse blob.

Retornar

String: o nome desses dados, se conhecido, ou null.


isGoogleType()

Retorna se este blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).

Retornar

Boolean: true se este blob for um arquivo do Google Workspace. false se não for.


setBytes(data)

Define os dados armazenados neste blob.

Parâmetros

NomeTipoDescrição
dataByte[]Os novos dados.

Retornar

Blob: este blob, para encadeamento.


setContentType(contentType)

Define o tipo de conteúdo dos bytes neste blob.

Parâmetros

NomeTipoDescrição
contentTypeStringO novo contentType.

Retornar

Blob: este blob, para encadeamento.


setContentTypeFromExtension()

Define o tipo de conteúdo de bytes neste blob com base na extensão do arquivo. O contentType será null se não puder ser adivinhado a partir da extensão.

Retornar

Blob: este blob, para encadeamento.


setDataFromString(string)

Define os dados desse blob de uma string com codificação UTF-8.

Parâmetros

NomeTipoDescrição
stringStringOs dados da string.

Retornar

Blob: este blob, para encadeamento.


setDataFromString(string, charset)

Define os dados desse blob de uma string com a codificação especificada.

Parâmetros

NomeTipoDescrição
stringStringOs dados da string.
charsetStringO charset a ser usado na interpretação da string como bytes.

Retornar

Blob: este blob, para encadeamento.


setName(name)

Define o nome deste blob.

Parâmetros

NomeTipoDescrição
nameStringO novo nome.

Retornar

Blob: este blob, para encadeamento.

Métodos obsoletos