Esta página foi traduzida pela API Cloud Translation.

Class MailApp

Envia e-mails.

Esse serviço permite que os usuários enviem e-mails com controle total sobre o conteúdo do e-mail. Ao contrário do GmailApp, a única finalidade do MailApp é enviar e-mails. O MailApp não pode acessar o Gmail de um usuário caixa de entrada.

É mais provável que as alterações em scripts escritos com o GmailApp acionem uma nova autorização. de um usuário do que os scripts do MailApp.

Métodos

Método	Tipo de retorno	Breve descrição
`getRemainingDailyQuota()`	`Integer`	Retorna o número de destinatários para os quais você pode enviar e-mails até o restante do dia.
`sendEmail(message)`	`void`	Envia uma mensagem de e-mail.
`sendEmail(recipient, subject, body)`	`void`	Envia uma mensagem de e-mail.
`sendEmail(recipient, subject, body, options)`	`void`	Envia uma mensagem de e-mail com argumentos opcionais.
`sendEmail(to, replyTo, subject, body)`	`void`	Envia uma mensagem de e-mail.

Documentação detalhada

`getRemainingDailyQuota()`

Retorna o número de destinatários para os quais você pode enviar e-mails até o restante do dia. O é válido para a execução atual e pode variar entre as execuções.

As cotas são baseadas no número de destinatários de e-mail. Para informações específicas sobre cotas, consulte Cotas do Google Serviços.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Retornar

Integer: o número de e-mails restantes que o script pode enviar.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.send_mail

`sendEmail(message)`

Envia uma mensagem de e-mail. Essa variação do método é muito mais flexível, permitindo que muitos mais opções.

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png";
  var youtubeLogoUrl =
        "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png";
  var googleLogoBlob = UrlFetchApp
                         .fetch(googleLogoUrl)
                         .getBlob()
                         .setName("googleLogoBlob");
  var youtubeLogoBlob = UrlFetchApp
                          .fetch(youtubeLogoUrl)
                          .getBlob()
                          .setName("youtubeLogoBlob");
  MailApp.sendEmail({
    to: "recipient@example.com",
    subject: "Logos",
    htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" +
              "inline YouTube Logo <img src='cid:youtubeLogo'>",
    inlineImages:
      {
        googleLogo: googleLogoBlob,
        youtubeLogo: youtubeLogoBlob
      }
  });
}

Parâmetros

Nome	Tipo	Descrição
`message`	`Object`	um objeto JavaScript que representa uma mensagem de e-mail

Parâmetros avançados

Nome	Tipo	Descrição
`attachments`	`BlobSource[]`	um matriz de arquivos para enviar com o e-mail
`bcc`	`String`	uma lista separada por vírgulas de endereços de e-mail para Cco
`body`	`String`	no corpo do e-mail
`cc`	`String`	uma lista separada por vírgulas de endereços de e-mail para Cc
`htmlBody`	`String`	Se definido, ele será usado pelos dispositivos capazes de processar HTML do argumento "body" obrigatório. é possível adicionar um campo `inlineImages` opcional em HTML corpo se você tiver imagens inline para seu e-mail
`inlineImages`	`Object`	um objeto JavaScript que contém um mapeamento da chave de imagem (`String`) aos dados da imagem (`BlobSource`); Isso pressupõe que o parâmetro `htmlBody` é usado e contém referências a essas imagens no formato `<img src="cid:imageKey" />` (veja o exemplo).
`name`	`String`	o nome do remetente do e-mail. O padrão é o do remetente nome de usuário
`noReply`	`Boolean`	`true` se o e-mail precisar ser enviado de um endereço genérico endereço de e-mail sem resposta para desencorajar os destinatários a responder a e-mails; essa opção está possível apenas para contas do Google Workspace, não para usuários do Gmail
`replyTo`	`String`	um endereço de e-mail para ser usado como o endereço padrão para resposta (padrão: o endereço de e-mail do usuário). Se `noReply` estiver definido como `true`, `replyTo` será ignorado.
`subject`	`String`	o assunto do e-mail
`to`	`String`	o endereço de e-mail do destinatário ou uma lista separada por vírgulas de endereços de e-mail sejam os destinatários

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.send_mail

Consulte também

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

Envia uma mensagem de e-mail.

MailApp.sendEmail("recipient@example.com",
                  "TPS reports",
                  "Where are the TPS reports?");

Parâmetros

Nome	Tipo	Descrição
`recipient`	`String`	os endereços dos destinatários, separados por vírgulas
`subject`	`String`	linha de assunto
`body`	`String`	no corpo do e-mail

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.send_mail

`sendEmail(recipient, subject, body, options)`

Envia uma mensagem de e-mail com argumentos opcionais.

// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html');
MailApp.sendEmail('mike@example.com', 'Attachment example', 'Two files are attached.', {
    name: 'Automatic Emailer Script',
    attachments: [file.getAs(MimeType.PDF), blob]
});

Parâmetros

Nome	Tipo	Descrição
`recipient`	`String`	os endereços dos destinatários, separados por vírgulas
`subject`	`String`	linha de assunto
`body`	`String`	no corpo do e-mail
`options`	`Object`	um objeto JavaScript que especifica parâmetros avançados, como listado abaixo

Parâmetros avançados

Nome	Tipo	Descrição
`attachments`	`BlobSource[]`	um matriz de arquivos para enviar com o e-mail (veja o exemplo)
`bcc`	`String`	uma lista separada por vírgulas de endereços de e-mail para Cco
`cc`	`String`	uma lista separada por vírgulas de endereços de e-mail para Cc
`htmlBody`	`String`	Se definido, ele será usado pelos dispositivos capazes de processar HTML do argumento "body" obrigatório. é possível adicionar um campo `inlineImages` opcional em HTML corpo se você tiver imagens inline para seu e-mail
`inlineImages`	`Object`	um objeto JavaScript que contém um mapeamento da chave de imagem (`String`) aos dados da imagem (`BlobSource`); Isso pressupõe que o parâmetro `htmlBody` é usado e contém referências a essas imagens no formato `<img src="cid:imageKey" />`
`name`	`String`	o nome do remetente do e-mail (padrão: o nome do usuário)
`noReply`	`Boolean`	`true` se o e-mail precisar ser enviado de um endereço genérico endereço de e-mail sem resposta para desencorajar os destinatários a responder a e-mails; essa opção está disponível apenas para contas do Google Workspace, e não para usuários do Gmail.
`replyTo`	`String`	um endereço de e-mail para ser usado como o endereço padrão para resposta (padrão: endereço de e-mail do usuário)

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.send_mail

Consulte também

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

Envia uma mensagem de e-mail. Esse método permite que um usuário especifique facilmente um Endereço de resposta para o mensagem enviada que pode ser diferente do remetente.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

Parâmetros

Nome	Tipo	Descrição
`to`	`String`	os endereços dos destinatários, separados por vírgulas
`replyTo`	`String`	o endereço para resposta
`subject`	`String`	linha de assunto
`body`	`String`	o corpo do e-mail em texto simples

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.send_mail