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 a caixa de entrada do Gmail de um usuário.
As alterações em scripts gravados com o GmailApp têm mais chances de acionar uma solicitação de nova autorização de um usuário do que os scripts de 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 pelo 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 pelo restante do dia. O valor retornado é 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 ver informações específicas sobre cotas, consulte Cotas para Serviços do Google.
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 exigem 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 muitas 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[] | uma matriz de arquivos a serem enviados com o e-mail |
bcc | String | Uma lista separada por vírgulas de endereços de e-mail para Cco |
body | String | o corpo do e-mail |
cc | String | uma lista de endereços de e-mail separados por vírgulas para Cc |
htmlBody | String | Se definida, os dispositivos capazes de renderizar o HTML o usarão em vez
do argumento do corpo necessário. Você poderá adicionar um campo inlineImages opcional no corpo do
HTML se tiver imagens in-line para seu e-mail |
inlineImages | Object | um objeto JavaScript que contém um mapeamento da chave de imagem (String ) para os dados de 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" /> (ver exemplo) |
name | String | o nome do remetente do e-mail. O padrão é o nome de usuário do remetente. |
noReply | Boolean | true : se o e-mail for enviado de um endereço genérico
sem resposta para desencorajar os destinatários a responder aos e-mails. Essa opção só
é possível para contas do Google Workspace, e não usuários do Gmail |
replyTo | String | Um endereço de e-mail para usar como endereço de resposta padrão (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 de endereços de e-mail separados por vírgula para serem os destinatários; |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.send_mail
Veja 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 | a linha de assunto; |
body | String | o corpo do e-mail |
Autorização
Os scripts que usam esse método exigem 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 | a linha de assunto; |
body | String | o corpo do e-mail |
options | Object | um objeto JavaScript que especifica parâmetros avançados, conforme listado abaixo |
Parâmetros avançados
Nome | Tipo | Descrição |
---|---|---|
attachments | BlobSource[] | uma matriz de arquivos a serem enviados com o e-mail (ver exemplo) |
bcc | String | Uma lista separada por vírgulas de endereços de e-mail para Cco |
cc | String | uma lista de endereços de e-mail separados por vírgulas para Cc |
htmlBody | String | Se definida, os dispositivos capazes de renderizar o HTML o usarão em vez
do argumento do corpo necessário. Você poderá adicionar um campo inlineImages opcional no corpo do
HTML se tiver imagens in-line para seu e-mail |
inlineImages | Object | um objeto JavaScript que contém um mapeamento da chave de imagem (String ) para os dados de 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 for enviado de um endereço genérico
sem resposta para desencorajar os destinatários a responder aos e-mails. Essa opção só
é possível para contas do Google Workspace, e não usuários do Gmail |
replyTo | String | Um endereço de e-mail para usar como endereço de resposta padrão (padrão: o endereço de e-mail do usuário) |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.send_mail
Veja 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 para resposta para a 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 | a linha de assunto; |
body | String | o corpo do e-mail em texto simples |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/script.send_mail