Esta página foi traduzida pela API Cloud Translation.

Class GmailAttachment

Um anexo do Gmail. Esse é um Blob normal, exceto pelo fato de ele ter um método getSize() extra que é mais rápido do que chamar. getBytes().length e não são contabilizados na cota de leitura do Gmail.

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var k = 0; k < attachments.length; k++) {
      Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
                 msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
    }
  }
}

Métodos

Método	Tipo de retorno	Breve descrição
`copyBlob()`	`Blob`	Retorna uma cópia desse blob.
`getAs(contentType)`	`Blob`	Retorna os dados dentro desse objeto como um blob convertido no tipo de conteúdo especificado.
`getBytes()`	`Byte[]`	Recebe os dados armazenados neste blob.
`getContentType()`	`String`	Recebe o tipo de conteúdo dos bytes neste blob.
`getDataAsString()`	`String`	Recebe os dados desse blob como uma string com codificação UTF-8.
`getDataAsString(charset)`	`String`	Recebe os dados desse blob como uma string com a codificação especificada.
`getHash()`	`String`	Recebe o hash de conteúdo SHA1 para este anexo.
`getName()`	`String`	Recebe o nome desse blob.
`getSize()`	`Integer`	Extrai o tamanho deste anexo.
`isGoogleType()`	`Boolean`	Retorna indicando se este blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).
`setBytes(data)`	`Blob`	Define os dados armazenados neste blob.
`setContentType(contentType)`	`Blob`	Define o tipo de conteúdo dos bytes neste blob.
`setContentTypeFromExtension()`	`Blob`	Define o tipo de conteúdo dos bytes neste blob com base na extensão do arquivo.
`setDataFromString(string)`	`Blob`	Define os dados deste blob de uma string com codificação UTF-8.
`setDataFromString(string, charset)`	`Blob`	Define os dados deste blob de uma string com a codificação especificada.
`setName(name)`	`Blob`	Define o nome desse blob.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getAllBlobs()`	`Blob[]`	Recebe todos os blobs contidos nesse blob (possivelmente composto).

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

Nome	Tipo	Descrição
`contentType`	`String`	O 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

Nome	Tipo	Descrição
`charset`	`String`	O conjunto de caracteres a ser usado na codificação dos dados nesse blob como uma string.

Retornar

String: os dados como uma string.

`getHash()`

Recebe o hash de conteúdo SHA1 para este anexo. Esse método não conta na conta do Gmail leitura.

Retornar

String: o hash de conteúdo SHA1, como uma string.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

https://mail.google.com/

`getName()`

Recebe o nome desse blob.

Retornar

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

`getSize()`

Extrai o tamanho deste anexo. Esse método é mais rápido do que chamar getBytes().length e não é contabilizado na cota de leitura do Gmail.

Retornar

Integer: o tamanho do anexo, em bytes.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

https://mail.google.com/

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