Class Blob

Blob

Um objeto de intercâmbio de dados para serviços do 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 no tipo de conteúdo especificado.
getBytes()Byte[]Recebe os dados armazenados neste 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 indicando 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 dos bytes neste blob com base na extensão do arquivo.
setDataFromString(string)BlobDefine os dados deste blob de uma string com codificação UTF-8.
setDataFromString(string, charset)BlobDefine os dados deste blob de uma string com a codificação especificada.
setName(name)BlobDefine o nome desse 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 no tipo de conteúdo especificado. Isso adiciona a extensão adequada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, pressupõe que a parte do nome do arquivo que segue o ponto final (se houver) é uma que deve ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ListaShopping.12.25.pdf".

Para acessar as cotas diárias para conversões, consulte Cotas do Google Serviços. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a medidas cotas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME em que a conversão será feita. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer um dos valores 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também precisa ser válidos. Para um documento do Documentos Google, 'text/markdown' também é válido.

Retornar

Blob: os dados como um blob.


getBytes()

Recebe os dados armazenados neste 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 conjunto de caracteres a ser usado na codificação dos 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 indicando se este blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).

Retornar

Boolean: true se este blob for um arquivo do Google Workspace. Caso contrário, false.


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 dos bytes neste blob com base na extensão do arquivo. O contentType é null se não puder ser adivinhado a partir de sua extensão.

Retornar

Blob: este blob, para encadeamento.


setDataFromString(string)

Define os dados deste 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 deste blob de uma string com a codificação especificada.

Parâmetros

NomeTipoDescrição
stringStringOs dados da string.
charsetStringO conjunto de caracteres a ser usado para interpretar a string como bytes.

Retornar

Blob: este blob, para encadeamento.


setName(name)

Define o nome desse blob.

Parâmetros

NomeTipoDescrição
nameStringO novo nome.

Retornar

Blob: este blob, para encadeamento.

Métodos obsoletos