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 |
---|---|---|
get | Integer | Indique le nombre de destinataires auxquels vous pouvez envoyer des e-mails pour le reste de la journée. |
send | void | Envoie un e-mail. |
send | void | Envoie un e-mail. |
send | void | Envoie un e-mail avec des arguments facultatifs. |
send | void | Envoie un e-mail. |
Documentation détaillée
get Remaining Daily Quota()
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
send Email(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 | Blob | 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 |
html | 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 inline facultatif dans le corps HTML si vous avez intégré des images à votre e-mail. |
inline | Object | un objet JavaScript contenant une mise en correspondance de la clé d'image (String ) aux données d'image (Blob ) ; cela suppose que le paramètre html 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. |
no | 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. |
reply | 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 no est défini sur true , reply 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
send Email(recipient, subject, body)
Envoie un e-mail.
App .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
send Email(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 | Blob | 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 |
html | 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 inline facultatif dans le corps HTML si vous avez intégré des images à votre e-mail. |
inline | Object | un objet JavaScript contenant une mise en correspondance de la clé d'image (String ) aux données d'image (Blob ) ; cela suppose que le paramètre html 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) |
no | 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. |
reply | 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
send Email(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.
App .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 ; |
reply | 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