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