Class GmailApp

Crée un brouillon d'e-mail. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.

// The code below creates a draft email with the current date and time.
const now = new Date();
GmailApp.createDraft(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

Paramètres

Renvois

GmailDraft : le brouillon Gmail qui vient d'être créé

Autorisation

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

• https://mail.google.com/

Voir aussi

• createDraft(recipient, subject, body, options)

Crée un brouillon d'e-mail avec des arguments facultatifs. L'e-mail peut contenir du texte brut ou un corps HTML. La taille de l'e-mail (y compris les en-têtes, mais à l'exclusion des pièces jointes) est limitée par un quota.

// Create a draft email with a file from Google Drive attached as a PDF.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft(
    'mike@example.com',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

Paramètres

Paramètres avancés

Renvois

GmailDraft : le brouillon Gmail qui vient d'être créé

Autorisation

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

• https://mail.google.com/

Voir aussi

• createDraft(recipient, subject, body)

Créez un libellé utilisateur avec le nom indiqué.

// Creates the label @FOO and logs label: FOO
Logger.log(`label: ${GmailApp.createLabel('FOO')}`);

Paramètres

Renvois

GmailLabel : le libellé nouvellement créé

Autorisation

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

• https://mail.google.com/

Voir aussi

• deleteLabel(label)

Supprime le libellé spécifié.

// Have to get the label by name first
const label = GmailApp.getUserLabelByName('FOO');
GmailApp.deleteLabel(label);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• createLabel(name)

Obtient la liste des adresses e-mail configurées comme alias pour ce compte dans Gmail.

Vous pouvez envoyer un message depuis l'un de ces alias en utilisant l'argument facultatif "from".

// Log the aliases for this Gmail account and send an email as the first one.
const me = Session.getActiveUser().getEmail();
const aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {
    from: aliases[0],
  });
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Renvois

String[] : tableau des alias pour ce compte

Autorisation

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

• https://mail.google.com/

Voir aussi

• sendEmail(recipient, subject, body, options)

Récupérez un brouillon d'e-mail par son ID.

Utilisez-le conjointement avec getId() sur les brouillons Gmail.

// Get the first draft message in your drafts folder
const draft = GmailApp.getDrafts()[0];
// Get its ID
const draftId = draft.getId();
// Now fetch the same draft using that ID.
const draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

Paramètres

Renvois

GmailDraft : brouillon avec l'ID donné

Génère

Error : si aucun brouillon ne correspond à l'ID indiqué

Autorisation

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

• https://mail.google.com/

Récupère tous les brouillons.

// Logs the number of draft messages
const drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Renvois

GmailMessage[] : un tableau de brouillons de messages Gmail

Autorisation

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

• https://mail.google.com/

Récupère tous les brouillons Gmail.

const drafts = GmailApp.getDrafts();
for (let i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Renvois

GmailDraft[] : un tableau de brouillons de messages Gmail

Autorisation

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

• https://mail.google.com/

Récupère tous les fils de discussion de la boîte de réception, quels que soient les libellés.

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

// Log the subject lines of your Inbox
const threads = GmailApp.getInboxThreads();
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans la boîte de réception

Autorisation

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

• https://mail.google.com/

Récupère une plage de fils de discussion de la boîte de réception, quels que soient les libellés.

// Log the subject lines of up to the first 50 emails in your Inbox
const threads = GmailApp.getInboxThreads(0, 50);
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Paramètres

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans la boîte de réception

Autorisation

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

• https://mail.google.com/

Obtient le nombre de fils de discussion non lus dans la boîte de réception.

Logger.log(`Messages unread in inbox: ${GmailApp.getInboxUnreadCount()}`);

Renvois

Integer : nombre de fils de discussion dans la boîte de réception qui contiennent des messages non lus

Autorisation

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

• https://mail.google.com/

Récupère un message par son ID.

Utilisez-le en association avec getId() sur les messages Gmail.

// Get the first message in the first thread of your inbox
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
const messageId = message.getId();
// Now fetch the same message using that ID.
const messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() === messageById.getSubject());

Paramètres

Renvois

GmailMessage : message avec l'ID indiqué

Génère

Error : si aucun message ne correspond à l'ID indiqué

Autorisation

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

• https://mail.google.com/

Voir aussi

• getThreadById(id)

Récupère tous les messages du fil de discussion spécifié.

// Log all the subject lines in the first thread of your inbox
const thread = GmailApp.getInboxThreads(0, 1)[0];
const messages = GmailApp.getMessagesForThread(thread);
for (let i = 0; i < messages.length; i++) {
  Logger.log(`subject: ${messages[i].getSubject()}`);
}

Paramètres

Renvois

GmailMessage[] : tableau de messages correspondant à ce fil de discussion

Autorisation

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

• https://mail.google.com/

Voir aussi

• getMessagesForThreads(threads)

Récupère tous les messages des threads spécifiés.

// Log the subject lines of all messages in the first two threads of your inbox
const thread = GmailApp.getInboxThreads(0, 2);
const messages = GmailApp.getMessagesForThreads(thread);
for (let i = 0; i < messages.length; i++) {
  for (let j = 0; j < messages[i].length; j++) {
    Logger.log(`subject: ${messages[i][j].getSubject()}`);
  }
}

Paramètres

Renvois

GmailMessage[][] : tableau de tableaux de messages, où chaque élément du tableau extérieur correspond à un fil de discussion et le tableau intérieur contient les messages de ce fil

Autorisation

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

• https://mail.google.com/

Voir aussi

• getMessagesForThread(thread)

Récupère tous les fils de discussion de la boîte de réception prioritaire, quels que soient les libellés.

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

Logger.log(
    `# of messages in your Priority Inbox: ${
        GmailApp.getPriorityInboxThreads().length}`,
);

Renvois

GmailThread[] : un tableau de fils de discussion Gmail 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 scopes suivants ou les scopes appropriés de l'API REST associée :

• https://mail.google.com/

Récupère une plage de fils de discussion de la boîte de réception Prioritaire, quels que soient les libellés.

// Will log some number 2 or less
Logger.log(
    `# of messages in your Priority Inbox: ${
        GmailApp.getPriorityInboxThreads(0, 2).length}`,
);

Paramètres

Renvois

GmailThread[] : un tableau de fils de discussion Gmail 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 scopes suivants ou les scopes appropriés de l'API REST associée :

• https://mail.google.com/

Obtient le nombre de fils de discussion non lus dans la boîte de réception Prioritaire.

Logger.log(
    `Number of unread emails in your Priority Inbox : ${
        GmailApp.getPriorityInboxUnreadCount()}`,
);

Renvois

Integer : nombre de fils de discussion dans la boîte de réception prioritaire qui contiennent des messages non lus

Autorisation

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

• https://mail.google.com/

Récupère tous les fils de discussion de spam, quels que soient les libellés.

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

Logger.log(`# of total spam threads: ${GmailApp.getSpamThreads().length}`);

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans le dossier "Spam"

Autorisation

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

• https://mail.google.com/

Récupère une plage de fils de discussion de spam, quels que soient les libellés.

// Will log a number at most 5
Logger.log(`# of total spam threads: ${GmailApp.getSpamThreads(0, 5).length}`);

Paramètres

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans le dossier "Spam"

Autorisation

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

• https://mail.google.com/

Obtient le nombre de fils de discussion non lus marqués comme spam.

// Unless you actually read stuff in your spam folder, this should be the same
// as the number of messages in your spam folder.
Logger.log(`# unread threads that are spam: ${GmailApp.getSpamUnreadCount()}`);

Renvois

Integer : nombre de fils de discussion de spam contenant des messages non lus

Autorisation

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

• https://mail.google.com/

Récupère tous les fils de discussion suivis, quels que soient les libellés.

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

// Logs the number of starred threads
Logger.log(`# Starred threads: ${GmailApp.getStarredThreads().length}`);

Renvois

GmailThread[] : un tableau de fils de discussion Gmail suivis

Autorisation

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

• https://mail.google.com/

Récupère une plage de fils étoilés, quels que soient les libellés.

// Logs the number of starred threads to a maximum of 5
Logger.log(`# Starred threads: ${GmailApp.getStarredThreads(0, 5).length}`);

Paramètres

Renvois

GmailThread[] : un tableau de fils de discussion Gmail suivis

Autorisation

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

• https://mail.google.com/

Obtient le nombre de fils de discussion non lus qui sont suivis.

Logger.log(`# unread and starred: ${GmailApp.getStarredUnreadCount()}`);

Renvois

Integer : nombre de fils de discussion suivis qui contiennent des messages non lus

Autorisation

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

• https://mail.google.com/

Récupère un fil de discussion par ID.

Utilisez-le en association avec getId() sur les fils de discussion Gmail.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(
    firstThread.getFirstMessageSubject() ===
        threadById.getFirstMessageSubject(),
);

Paramètres

Renvois

GmailThread|null : le fil de discussion associé à l'ID donné ou null s'il est introuvable.

Autorisation

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

• https://mail.google.com/

Voir aussi

• getMessageById(id)

Récupère tous les fils de discussion mis à la corbeille, quels que soient les libellés.

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

Logger.log(`# of total trash threads: ${GmailApp.getTrashThreads().length}`);

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans la corbeille

Autorisation

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

• https://mail.google.com/

Récupère une plage de fils de discussion placés dans la corbeille, quels que soient les libellés.

// Will log a number at most 5
Logger.log(
    `# of total trash threads: ${GmailApp.getTrashThreads(0, 5).length}`,
);

Paramètres

Renvois

GmailThread[] : un tableau de fils de discussion Gmail dans la corbeille

Autorisation

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

• https://mail.google.com/

Récupère un libellé à partir de son nom.

const labelObject = GmailApp.getUserLabelByName('myLabel');

Paramètres

Renvois

GmailLabel : libellé Gmail portant le nom indiqué

Autorisation

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

• https://mail.google.com/

Récupère la liste des libellés créés par l'utilisateur.

// Logs all of the names of your labels
const labels = GmailApp.getUserLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(`label: ${labels[i].getName()}`);
}

Renvois

GmailLabel[] : tableau de libellés créés par l'utilisateur

Autorisation

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

• https://mail.google.com/

Marque ce message comme lu et le force à s'actualiser.

// Mark the first message in the first thread of your inbox as read
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markMessageUnread(message)

Marque ce message comme non lu et force son actualisation.

// Mark the first message in the first thread of your inbox as unread
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markMessageRead(message)

Marque ces messages comme lus et les actualise.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
const threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
const messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(messages);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markMessagesUnread(messages)

Marque ces messages comme non lus et force leur actualisation.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
const threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
const messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(messages);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markMessagesRead(messages)

Marque ce fil de discussion comme important et le force à s'actualiser.

// Marks first inbox thread as important
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadUnimportant(thread)

Marque ce fil de discussion comme lu et force son actualisation.

// Marks first inbox thread as read
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadUnread(thread)

Marque ce fil de discussion comme non important et force son actualisation.

// Marks first inbox thread as unimportant
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadImportant(thread)

Marque ce fil de discussion comme non lu et force son actualisation.

// Marks first inbox thread as unread
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadRead(thread)

Marque ces fils de discussion comme importants et les actualise.

// Marks first two threads in inbox as important
const threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadsUnimportant(threads)

Marque ces fils de discussion comme lus et les actualise.

// Marks first two threads in inbox as read
const threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadsUnread(threads)

Marque ces fils de discussion comme non importants et les actualise.

// Marks first two threads in inbox as unimportant
const threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadsImportant(threads)

Marque ces fils de discussion comme non lus et les actualise.

// Marks first two threads in inbox as unread
const threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• markThreadsRead(threads)

Place le message dans la corbeille et force son actualisation.

// Move the first message in your inbox to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Paramètres

Renvois

GmailApp : service Gmail (utile pour l'enchaînement)

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveMessagesToTrash(messages)

Déplace les messages spécifiés dans la corbeille et force l'actualisation des messages.

// Move first two messages in your inbox to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
const toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Paramètres

Renvois

GmailApp : service Gmail (utile pour l'enchaînement)

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveMessageToTrash(message)

Déplace ce fil de discussion vers l'archive et force son actualisation.

// Archive the first thread in your inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToArchive(firstThread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

Déplace ce fil de discussion vers la boîte de réception et force son actualisation.

// Find a thread not already in your inbox
const thread = GmailApp.search('-in:inbox')[0];  // Get the first one
GmailApp.moveThreadToInbox(thread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

Déplace ce fil de discussion dans le spam et force son actualisation.

// Tag first thread in inbox as spam
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToSpam(firstThread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

Déplace ce fil de discussion vers la corbeille et force son actualisation.

// Move first thread in inbox to trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToTrash(firstThread);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

Déplace ces fils de discussion vers l'archive et force leur actualisation.

// Move first two threads in your inbox to the archive
const firstTwoThreads = GmailApp.getInboxThreads(0, 2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

Déplace ces fils de discussion vers la boîte de réception et les actualise.

// Find two threads not already in your inbox
const firstTwoThreads = GmailApp.search('-in:inbox', 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

Déplace ces fils de discussion dans le spam et les actualise.

// Move first two threads in your inbox to spam
const firstTwoThreads = GmailApp.getInboxThreads(0, 2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

Déplace ces fils de discussion vers la corbeille et les actualise.

// Move first two threads in your inbox to trash
const firstTwoThreads = GmailApp.getInboxThreads(0, 2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• refreshMessages(messages)

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• refreshMessage(message)

Recharge le fil de discussion et l'état associé depuis Gmail (utile si les libellés, l'état de lecture, etc. ont changé).

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• refreshThreads(threads)

Recharge les fils de discussion et l'état associé depuis Gmail (utile si les libellés, l'état de lecture, etc., ont changé).

const threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• refreshThread(thread)

Rechercher dans Gmail avec la requête donnée

Cet appel échouera si la taille de tous les threads est trop importante pour que le système puisse la gérer. Lorsque la taille du thread est inconnue et potentiellement très grande, veuillez utiliser l'appel "paginé" et spécifier les plages de threads à récupérer dans chaque appel.

// Find starred messages with subject IMPORTANT
const threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Paramètres

Renvois

GmailThread[] : tableau de fils de discussion Gmail correspondant à cette requête

Autorisation

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

• https://mail.google.com/

Rechercher dans Gmail avec la requête donnée

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty
// array.
const threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Paramètres

Renvois

GmailThread[] : tableau de fils de discussion Gmail correspondant à cette requête

Autorisation

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

• https://mail.google.com/

Envoie un message par e-mail. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.

// The code below will send an email with the current date and time.
const now = new Date();
GmailApp.sendEmail(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• sendEmail(recipient, subject, body, options)

Envoie un e-mail avec des arguments facultatifs. L'e-mail peut contenir du texte brut ou un corps HTML. La taille de l'e-mail (y compris les en-têtes, mais à l'exclusion des pièces jointes) est limitée par un quota.

// Send an email with a file from Google Drive attached as a PDF.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail(
    'mike@example.com',
    'Attachment example',
    'Please see the attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

Paramètres

Paramètres avancés

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• sendEmail(recipient, subject, body)

Définit le jeton d'accès au message actuel qui permet au script d'accéder aux propriétés GmailMessage actuelles.

Seuls les projets de modules complémentaires Google Workspace utilisant les scopes de message actuels de Gmail nécessitent cette méthode.

function handleAddonActionEvent(e) {
  GmailApp.setCurrentMessageAccessToken(e.messageMetadata.accessToken);
  const mailMessage = GmailApp.getMessageById(e.messageMetadata.messageId);
  // Do something with mailMessage
}

Paramètres

Autorisation

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

• https://mail.google.com/

Ajoute une étoile à ce message et force son actualisation.

// Stars the first message in the first thread in your inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• starMessages(messages)

Ajoute des étoiles à ces messages et les actualise.

// Stars the first three messages in the first thread in your inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• starMessage(message)

Supprime le suivi de ce message et force son actualisation.

// Unstars the first message in the first thread in your inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• unstarMessages(messages)

Supprime le suivi de ces messages et les actualise.

// Unstars the first three messages in the first thread in your inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Paramètres

Renvois

GmailApp : service Gmail, utile pour l'enchaînement

Autorisation

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

• https://mail.google.com/

Voir aussi

• unstarMessage(message)