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á
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: 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)
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(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