Um objeto de troca de dados para serviços do Apps Script.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
copy | Blob | Retorna uma cópia desse blob. |
get | Blob | Retorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado. |
get | Byte[] | Consegue os dados armazenados neste blob. |
get | String | Recebe o tipo de conteúdo dos bytes neste blob. |
get | String | Recebe os dados desse blob como uma string com codificação UTF-8. |
get | String | Consegue os dados desse blob como uma string com a codificação especificada. |
get | String | Extrai o nome desse blob. |
is | Boolean | Retorna se o blob é um arquivo do Google Workspace (Planilhas, Documentos etc.). |
set | Blob | Define os dados armazenados neste blob. |
set | Blob | Define o tipo de conteúdo dos bytes neste blob. |
set | Blob | Define o tipo de conteúdo dos bytes neste blob com base na extensão do arquivo. |
set | Blob | Define os dados desse blob de uma string com codificação UTF-8. |
set | Blob | Define os dados desse blob de uma string com a codificação especificada. |
set | Blob | Define o nome do blob. |
Métodos obsoletos
Método | Tipo de retorno | Breve descrição |
---|---|---|
| Blob[] | Recebe todos os blobs contidos neste blob (talvez composto). |
Documentação detalhada
copyBlob()
getAs(contentType)
Retorna os dados dentro deste 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, ele pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".
Para conferir as cotas diárias de conversões, consulte Cotas dos Serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
content | String | O tipo MIME para 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 formatos 'image/bmp' , 'image/gif' , 'image/jpeg' ou 'image/png' também é
válido. Para um documento do Documentos Google, 'text/markdown' também é válido. |
Retornar
Blob
: os dados como um blob.
getBytes()
Consegue 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)
Consegue os dados desse blob como uma string com a codificação especificada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
charset | String | O conjunto de caracteres a ser usado para codificar os dados neste blob como uma string. |
Retornar
String
: os dados como uma string.
getName()
Extrai o nome desse blob.
Retornar
String
: o nome desses dados, se conhecido, ou null
.
isGoogleType()
Retorna se o blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).
Retornar
Boolean
: true
se o blob for um arquivo do Google Workspace; false
, caso contrário.
setBytes(data)
Define os dados armazenados neste blob.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
data | Byte[] | Os novos dados. |
Retornar
Blob
: este blob, para encadeamento.
setContentType(contentType)
Define o tipo de conteúdo dos bytes neste blob.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
content | String | O 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 pela 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
Nome | Tipo | Descrição |
---|---|---|
string | String | Os 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
Nome | Tipo | Descrição |
---|---|---|
string | String | Os dados da string. |
charset | String | O conjunto de caracteres a ser usado na interpretação da string como bytes. |
Retornar
Blob
: este blob, para encadeamento.
setName(name)
Define o nome do blob.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | O novo nome. |
Retornar
Blob
: este blob, para encadeamento.
Métodos obsoletos
getAllBlobs()
getAllBlobs()
Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.
Recebe todos os blobs contidos neste blob (talvez composto).
Retornar
Blob[]
: os blobs contidos no blob.