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 gardant un contrôle total sur le contenu de l'e-mail. Contrairement à GmailApp, la seule fonction de MailApp est d'envoyer des e-mails. MailApp ne peut pas accéder à la boîte de réception Gmail d'un utilisateur.

Les modifications apportées aux scripts écrits à l'aide de GmailApp sont plus susceptibles de déclencher une demande de réautorisation de la part 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 des 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 d'e-mails. Pour obtenir des informations spécifiques sur les quotas, consultez la page Quotas pour les services Google.

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 associée à 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, ce qui permet de définir beaucoup plus d'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`	Objet JavaScript représentant un e-mail

Paramètres avancés

Nom	Type	Description
`attachments`	`BlobSource[]`	Tableau de fichiers à envoyer avec l'adresse e-mail
`bcc`	`String`	d'une liste d'adresses e-mail séparées par une virgule en Cci
`body`	`String`	le corps de l'e-mail ;
`cc`	`String`	d'une liste d'adresses e-mail séparées par une virgule en copie
`htmlBody`	`String`	Si cette valeur est définie, les appareils capables d'afficher le code HTML l'utiliseront à la place de l'argument obligatoire du corps. Vous pouvez ajouter un champ facultatif `inlineImages` dans le corps HTML si vous avez intégré des images à votre e-mail
`inlineImages`	`Object`	Objet JavaScript contenant un mappage entre clé d'image (`String`) et 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 d'utilisateur de l'expéditeur.
`noReply`	`Boolean`	`true` si l'e-mail doit être envoyé à partir d'une adresse e-mail générique qui ne doit pas recevoir de réponse afin de dissuader les destinataires de répondre (cette option n'est disponible que pour les comptes Google Workspace, pas pour les utilisateurs Gmail)
`replyTo`	`String`	Une adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut: l'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 d'adresses e-mail séparées par une virgule correspondant aux destinataires

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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`	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 associée à 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 des 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`	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 les paramètres avancés, listés ci-dessous ;

Paramètres avancés

Nom	Type	Description
`attachments`	`BlobSource[]`	Tableau de fichiers à envoyer avec l'e-mail (voir l'exemple)
`bcc`	`String`	d'une liste d'adresses e-mail séparées par une virgule en Cci
`cc`	`String`	d'une liste d'adresses e-mail séparées par une virgule en copie
`htmlBody`	`String`	Si cette valeur est définie, les appareils capables d'afficher le code HTML l'utiliseront à la place de l'argument obligatoire du corps. Vous pouvez ajouter un champ facultatif `inlineImages` dans le corps HTML si vous avez intégré des images à votre e-mail
`inlineImages`	`Object`	Objet JavaScript contenant un mappage entre clé d'image (`String`) et 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: le nom de l'utilisateur)
`noReply`	`Boolean`	`true` si l'e-mail doit être envoyé à partir d'une adresse e-mail générique qui ne doit pas recevoir de réponse afin de dissuader les destinataires de répondre (cette option n'est disponible que pour les comptes Google Workspace, pas pour les utilisateurs Gmail)
`replyTo`	`String`	Une adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut: l'adresse e-mail de l'utilisateur)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 à un utilisateur de spécifier facilement pour le message envoyé une adresse de réponse 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`	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 associée à un ou plusieurs des champs d'application suivants:

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