Class GmailMessage

Crée un brouillon pour répondre à l'expéditeur de ce message en utilisant l'adresse de réponse. La la taille de l'e-mail (en-têtes compris) est limitée par le quota.

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

Paramètres

Renvois

GmailDraft : brouillon du nouveau message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

Crée un brouillon pour répondre à l'expéditeur de ce message en utilisant l'adresse de réponse, avec arguments facultatifs.

L'e-mail peut contenir du texte brut et un corps de texte HTML. La taille de l'e-mail (y compris en-têtes) correspond au quota limitée.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Paramètres

Paramètres avancés

Renvois

GmailDraft : brouillon du nouveau message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

Crée un brouillon de message répondant à l'expéditeur en utilisant l'adresse de réponse et tous les destinataires de ce message. La taille de l'e-mail (en-têtes compris) est limitée par le quota.

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Paramètres

Renvois

GmailDraft : brouillon du nouveau message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

Crée un brouillon pour répondre à l'expéditeur de ce message en utilisant l'adresse de réponse et tous les destinataires, avec des arguments facultatifs.

L'e-mail peut contenir du texte brut et un corps de texte HTML. La taille de l'e-mail (y compris en-têtes) correspond au quota limitée.

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Paramètres

Paramètres avancés

Renvois

GmailDraft : brouillon du nouveau message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

Transfère ce message à de nouveaux destinataires. La taille de l'e-mail (en-têtes compris) est limitée par le quota.

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

Paramètres

Renvois

GmailMessage : message utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• forward(recipient, options)

Transfère ce message à de nouveaux destinataires, avec des arguments facultatifs.

L'e-mail peut contenir du texte brut et un corps de texte HTML. La taille de l'e-mail (en-têtes inclus) correspond au quota limitée.

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Paramètres

Paramètres avancés

Renvois

GmailMessage : message utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• forward(recipient)

Récupère toutes les pièces jointes de ce message.

Renvois

GmailAttachment[] : tableau de pièces jointes Blob pour ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère toutes les pièces jointes de ce message.

Paramètres

Paramètres avancés

Renvois

GmailAttachment[] : tableau de pièces jointes Blob pour ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère les destinataires séparés par une virgule en copie cachée sur ce message.

Ce champ est vide pour tous les messages reçus, par définition.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

Renvois

String : destinataires (séparés par une virgule) mis en copie dans ce message en copie cachée

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getTo()

Récupère le contenu HTML du corps de ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

Renvois

String : contenu du corps de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getSubject()

Récupère les destinataires en copie de ce message, séparés par une virgule.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

Renvois

String : destinataires en copie de ce message, séparés par une virgule.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getTo()

Récupère la date et l'heure de ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

Renvois

Date : date et heure de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère l'expéditeur de ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

Renvois

String : adresse e-mail de l'expéditeur du message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getReplyTo()

Récupère la valeur d'un en-tête RFC 2822 en fonction du nom d'en-tête.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

Paramètres

Renvois

String : valeur de l'en-tête ou chaîne vide si l'en-tête n'existe pas dans le message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère l'ID de ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

Renvois

String : ID du message.

Récupère le contenu du corps de ce message sans mise en forme HTML. Ceci est plus complexe que getBody() et prend plus de temps.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

Renvois

String : contenu du corps brut de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getSubject()

Récupère le contenu brut de ce message. Cela équivaut à "Afficher l'original". dans l'interface utilisateur de Gmail.

Renvois

String : contenu brut de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère l'adresse de réponse de ce message (généralement l'expéditeur).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

Renvois

String : adresse e-mail utilisée pour les réponses.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getCc()

Récupère l'objet de ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

Renvois

String : objet de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getAttachments()

Récupère le fil de discussion qui contient ce message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

Renvois

GmailThread : fil GmailThread qui contient ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Récupère les destinataires de ce message, séparés par une virgule.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

Renvois

String : destinataires de ce message, séparés par une virgule.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• getCc()

Détermine si ce message est un brouillon.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

Renvois

Boolean : indique si ce message est un brouillon.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Détermine si ce message correspond à un chat.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

Renvois

Boolean : indique si ce message est un chat

Détermine si ce message se trouve dans la boîte de réception.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

Renvois

Boolean : indique si le message se trouve dans la boîte de réception.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Renvoie true si ce message se trouve dans la boîte de réception prioritaire. renvoie false dans le cas contraire.

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

Renvois

Boolean : indique si ce message se trouve dans la boîte de réception Prioritaire.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Détermine si ce message se trouve dans la corbeille.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

Renvois

Boolean : indique si ce message se trouve dans la corbeille.

Détermine si ce message est suivi.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

Renvois

Boolean : indique si le message est suivi ou non.

Détermine si ce message n'est pas lu.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

Renvois

Boolean : état "Non lu" de ce message.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Marque le message comme lu.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

Renvois

GmailMessage : ce GmailMessage, utile pour les enchaînements.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• isUnread()

Marque le message comme non lu.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

Renvois

GmailMessage : ce GmailMessage, utile pour les enchaînements.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• isUnread()

Permet de placer le message dans la corbeille.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

Renvois

GmailMessage : ce GmailMessage, utile pour les enchaînements.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• isInTrash()

Actualise ce message et l'état associé depuis Gmail (utile si les libellés, l'état de lecture, etc., ont changé).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

Renvois

GmailMessage : message à associer au chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Permet de répondre à l'expéditeur de ce message en utilisant l'adresse de réponse. La taille de l'e-mail (en-têtes inclus) correspond au quota limitée.

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

Paramètres

Renvois

GmailMessage : message utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

Répondre à l'expéditeur de ce message en utilisant l'adresse de réponse, avec des arguments facultatifs.

L'e-mail peut contenir du texte brut et un corps de texte HTML. La taille de l'e-mail (en-têtes inclus) correspond au quota limitée.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Paramètres

Paramètres avancés

Renvois

GmailMessage : message utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body)
• replyAll(body)
• replyAll(body, options)

Répondre à l'expéditeur en utilisant l'adresse de réponse et tous les destinataires de ce message Taille de l'e-mail (y compris les en-têtes) est limité par un quota.

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

Paramètres

Renvois

GmailMessage : ce message est utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body)
• reply(body, options)
• replyAll(body, options)

Répondre à l'expéditeur de ce message en utilisant l'adresse de réponse et tous les destinataires, avec arguments facultatifs.

L'e-mail peut contenir du texte brut et un corps de texte HTML. La taille de l'e-mail (en-têtes inclus) correspond au quota limitée.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Paramètres

Paramètres avancés

Renvois

GmailMessage : message utile pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• reply(body)
• reply(body, options)
• replyAll(body)

Permet d'activer le suivi du message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

Renvois

GmailMessage : ce GmailMessage, utile pour les enchaînements.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• unstar()

Désactive le suivi du message.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

Renvois

GmailMessage : ce GmailMessage, utile pour les enchaînements.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants, ou des champs d'application appropriés de l'API REST associée:

• https://mail.google.com/

Voir aussi

• star()