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)
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(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