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 contrôlant entièrement leur contenu. Contrairement à GmailApp, MailApp a pour seul but 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`	Indique 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()`

Indique 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 en savoir plus sur les quotas, consultez la page Quotas pour les services Google.

const 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 avec 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 d'avoir davantage d'options.

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const 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[]`	un tableau de fichiers à envoyer avec l'e-mail
`bcc`	`String`	une liste d'adresses e-mail à ajouter en Cci, séparées par une virgule
`body`	`String`	le corps de l'e-mail ;
`cc`	`String`	une liste d'adresses e-mail à ajouter à la liste des destinataires Cc, séparées par une virgule
`htmlBody`	`String`	Si défini, les appareils capables d'afficher du code HTML l'utiliseront à la place de l'argument de corps obligatoire. Vous pouvez ajouter un champ `inlineImages` facultatif dans le corps HTML si vous avez intégré des images à votre e-mail.
`inlineImages`	`Object`	un objet JavaScript contenant une mise en correspondance de la clé d'image (`String`) aux données d'image (`BlobSource`) ; cela suppose que le paramètre `htmlBody` est utilisé et contient des références à ces images au format `<img src="cid:imageKey" />` (voir exemple)
`name`	`String`	le nom de l'expéditeur de l'e-mail. Par défaut, il s'agit du 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 ne permettant pas de répondre pour dissuader les destinataires de répondre aux e-mails. Cette option n'est possible que 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: 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 à utiliser comme destinataires

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une virgule ;
`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 avec 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.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 une virgule ;
`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[]`	un tableau de fichiers à envoyer avec l'e-mail (voir exemple)
`bcc`	`String`	une liste d'adresses e-mail à ajouter en Cci, séparées par une virgule
`cc`	`String`	une liste d'adresses e-mail à ajouter à la liste des destinataires Cc, séparées par une virgule
`htmlBody`	`String`	Si défini, les appareils capables d'afficher du code HTML l'utiliseront à la place de l'argument de corps obligatoire. Vous pouvez ajouter un champ `inlineImages` facultatif dans le corps HTML si vous avez intégré des images à votre e-mail.
`inlineImages`	`Object`	un objet JavaScript contenant une mise en correspondance de la clé d'image (`String`) aux données d'image (`BlobSource`) ; cela suppose que le paramètre `htmlBody` est utilisé et 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é à partir d'une adresse e-mail générique ne permettant pas de répondre pour dissuader les destinataires de répondre aux e-mails. Cette option n'est possible que 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: l'adresse e-mail de l'utilisateur)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une adresse de réponse pour le message envoyé, qui peut être différente de celle 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 une virgule ;
`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 avec un ou plusieurs des champs d'application suivants:

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