Class MailApp

MailApp

Envoie un e-mail.

Ce service permet aux utilisateurs d'envoyer des e-mails en ayant un contrôle total sur le contenu des e-mails. Contrairement à GmailApp, le seul objectif de MailApp est d'envoyer des e-mails. MailApp ne peut pas accéder au compte Gmail d'un utilisateur boîte de réception.

Les modifications apportées aux scripts écrits à l'aide de GmailApp sont plus susceptibles de déclencher une nouvelle autorisation requête d'un utilisateur que les scripts MailApp.

Méthodes

MéthodeType renvoyéBrève description
getRemainingDailyQuota()IntegerRenvoie le nombre de destinataires auxquels vous pouvez envoyer des e-mails pour le reste de la journée.
sendEmail(message)voidEnvoie un e-mail.
sendEmail(recipient, subject, body)voidEnvoie un e-mail.
sendEmail(recipient, subject, body, options)voidEnvoie un e-mail avec les arguments facultatifs.
sendEmail(to, replyTo, subject, body)voidEnvoie un e-mail.

Documentation détaillée

getRemainingDailyQuota()

Renvoie le nombre de destinataires auxquels vous pouvez envoyer des e-mails pour le reste de la journée. La valeur renvoyée est valide pour l'exécution en cours et peut varier d'une exécution à l'autre.

Les quotas sont basés sur le nombre de destinataires des e-mails. Pour obtenir des informations spécifiques sur les quotas, consultez la page Quotas Services.

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

Renvois

Integer : nombre d'e-mails restants que le script peut envoyer.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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

sendEmail(message)

Envoie un e-mail. Cette variante de la méthode est beaucoup plus flexible, d'autres options.

// 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
      }
  });
}

Paramètres

NomTypeDescription
messageObjectUn objet JavaScript représentant un e-mail

Paramètres avancés

NomTypeDescription
attachmentsBlobSource[]une tableau de fichiers à envoyer avec l'adresse e-mail
bccStringune liste d'adresses e-mail séparées par une virgule à mettre en Cci
bodyStringle corps de l'e-mail
ccStringune liste d'adresses e-mail séparées par une virgule à mettre en Cc
htmlBodyStringSi cette règle est définie, les appareils capables d'afficher le code HTML l'utilisent à la place de l'argument "body" requis ; vous pouvez ajouter un champ inlineImages facultatif en HTML corps si vous avez des images intégrées pour votre e-mail
inlineImagesObjectObjet JavaScript contenant un mappage à partir de la clé d'image (String) vers les données d'image (BlobSource) Cela suppose que le paramètre htmlBody est utilisé et qu'il contient des références à ces images au format <img src="cid:imageKey" /> (voir l'exemple).
nameStringle nom de l'expéditeur de l'e-mail. La valeur par défaut est le nom de l'expéditeur nom d'utilisateur.
noReplyBooleantrue si l'e-mail doit être envoyé depuis un adresse e-mail n'acceptant pas de réponse visant à dissuader les destinataires de répondre aux e-mails cette option est Uniquement possible pour les comptes Google Workspace, et non pour les utilisateurs Gmail
replyToStringUne adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut: adresse e-mail de l'utilisateur). Si noReply est défini sur true, replyTo est ignoré.
subjectStringl'objet de l'e-mail
toStringl'adresse e-mail du destinataire ou une liste de les adresses e-mail des destinataires

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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

Voir aussi


sendEmail(recipient, subject, body)

Envoie un e-mail.

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

Paramètres

NomTypeDescription
recipientStringles adresses des destinataires, séparées par des virgules.
subjectStringla ligne d'objet
bodyStringle corps de l'e-mail

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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

sendEmail(recipient, subject, body, options)

Envoie un e-mail avec les arguments facultatifs.

// 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]
});

Paramètres

NomTypeDescription
recipientStringles adresses des destinataires, séparées par des virgules.
subjectStringla ligne d'objet
bodyStringle corps de l'e-mail
optionsObjectUn objet JavaScript qui spécifie des paramètres avancés, comme indiqué ci-dessous

Paramètres avancés

NomTypeDescription
attachmentsBlobSource[]une tableau de fichiers à envoyer avec l'adresse e-mail (voir l'exemple)
bccStringune liste d'adresses e-mail séparées par une virgule à mettre en Cci
ccStringune liste d'adresses e-mail séparées par une virgule à mettre en Cc
htmlBodyStringSi cette règle est définie, les appareils capables d'afficher le code HTML l'utilisent à la place de l'argument "body" requis ; vous pouvez ajouter un champ inlineImages facultatif en HTML corps si vous avez des images intégrées pour votre e-mail
inlineImagesObjectObjet JavaScript contenant un mappage à partir de la clé d'image (String) vers les données d'image (BlobSource) Cela suppose que le paramètre htmlBody est utilisé et qu'il contient des références à ces images au format <img src="cid:imageKey" />.
nameStringNom de l'expéditeur de l'e-mail (par défaut: nom de l'utilisateur)
noReplyBooleantrue si l'e-mail doit être envoyé depuis un adresse e-mail n'acceptant pas de réponse visant à dissuader les destinataires de répondre aux e-mails cette option est Uniquement possible pour les comptes Google Workspace, et non pour les utilisateurs Gmail
replyToStringUne adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut: adresse e-mail de l'utilisateur)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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

Voir aussi


sendEmail(to, replyTo, subject, body)

Envoie un e-mail. Cette méthode permet à l'utilisateur de spécifier facilement une adresse de réponse pour le champ envoyé qui peut différer de l'expéditeur.

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

Paramètres

NomTypeDescription
toStringles adresses des destinataires, séparées par des virgules.
replyToStringl'adresse de réponse
subjectStringla ligne d'objet
bodyStringle corps de l'e-mail en texte brut

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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