Cette page a été traduite par l'API Cloud Translation.

Class 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éthode	Type renvoyé	Brève description
`getRemainingDailyQuota()`	`Integer`	Renvoie le nombre de destinataires auxquels vous pouvez envoyer des e-mails pour le reste de la journée.
`sendEmail(message)`	`void`	Envoie un e-mail.
`sendEmail(recipient, subject, body)`	`void`	Envoie un e-mail.
`sendEmail(recipient, subject, body, options)`	`void`	Envoie un e-mail avec les arguments facultatifs.
`sendEmail(to, replyTo, subject, body)`	`void`	Envoie 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

Nom	Type	Description
`message`	`Object`	Un objet JavaScript représentant un e-mail

Paramètres avancés

Nom	Type	Description
`attachments`	`BlobSource[]`	une tableau de fichiers à envoyer avec l'adresse e-mail
`bcc`	`String`	une liste d'adresses e-mail séparées par une virgule à mettre en Cci
`body`	`String`	le corps de l'e-mail
`cc`	`String`	une liste d'adresses e-mail séparées par une virgule à mettre en Cc
`htmlBody`	`String`	Si 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
`inlineImages`	`Object`	Objet 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).
`name`	`String`	le nom de l'expéditeur de l'e-mail. La valeur par défaut est le nom de l'expéditeur nom d'utilisateur.
`noReply`	`Boolean`	`true` 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
`replyTo`	`String`	Une 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é.
`subject`	`String`	l'objet de l'e-mail
`to`	`String`	l'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, options)

`sendEmail(recipient, subject, body)`

Envoie un e-mail.

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

Paramètres

Nom	Type	Description
`recipient`	`String`	les adresses des destinataires, séparées par des virgules.
`subject`	`String`	la ligne d'objet
`body`	`String`	le 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

Nom	Type	Description
`recipient`	`String`	les adresses des destinataires, séparées par des virgules.
`subject`	`String`	la ligne d'objet
`body`	`String`	le corps de l'e-mail
`options`	`Object`	Un objet JavaScript qui spécifie des paramètres avancés, comme indiqué ci-dessous

Paramètres avancés

Nom	Type	Description
`attachments`	`BlobSource[]`	une tableau de fichiers à envoyer avec l'adresse e-mail (voir l'exemple)
`bcc`	`String`	une liste d'adresses e-mail séparées par une virgule à mettre en Cci
`cc`	`String`	une liste d'adresses e-mail séparées par une virgule à mettre en Cc
`htmlBody`	`String`	Si 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
`inlineImages`	`Object`	Objet 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" />`.
`name`	`String`	Nom de l'expéditeur de l'e-mail (par défaut: nom de l'utilisateur)
`noReply`	`Boolean`	`true` 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
`replyTo`	`String`	Une 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(message)

`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

Nom	Type	Description
`to`	`String`	les adresses des destinataires, séparées par des virgules.
`replyTo`	`String`	l'adresse de réponse
`subject`	`String`	la ligne d'objet
`body`	`String`	le 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