Esta página foi traduzida pela API Cloud Translation.

Class GmailAttachment

Um anexo do Gmail. Essa é uma função Blob normal, exceto pelo fato de ter um método getSize() extra que é mais rápido do que chamar getBytes().length e não é incluída 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 para o tipo de conteúdo especificado.
`getBytes()`	`Byte[]`	Recebe os dados armazenados nesse 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`	Recebe o tamanho desse anexo.
`isGoogleType()`	`Boolean`	Retorna 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 de bytes neste blob com base na extensão do arquivo.
`setDataFromString(string)`	`Blob`	Define os dados desse blob de uma string com codificação UTF-8.
`setDataFromString(string, charset)`	`Blob`	Define os dados desse blob de uma string com a codificação especificada.
`setName(name)`	`Blob`	Define o nome deste blob.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getAllBlobs()`	`Blob[]`	Recebe todos os blobs contidos neste 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 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

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

Nome	Tipo	Descrição
`charset`	`String`	O charset a ser usado para codificar os 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 é contabilizado na cota de leitura do Gmail.

Retornar

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

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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()`

Recebe o tamanho desse anexo. Esse método é mais rápido 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 exigem autorização com um ou mais dos seguintes escopos ou escopos apropriados da API REST relacionada:

https://mail.google.com/

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