Fil de discussion dans le compte Gmail d'un utilisateur.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Gmail | Ajoute ce libellé au fil de discussion. |
create | Gmail | Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion à l'aide de l'adresse de réponse. |
create | Gmail | Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion à l'aide de l'adresse de réponse, avec des arguments facultatifs. |
create | Gmail | Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion, en utilisant l'adresse de réponse et tous les destinataires de ce message. |
create | Gmail | Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion, en utilisant l'adresse de réponse et tous les destinataires, avec des arguments facultatifs. |
get | String | Récupère l'objet du premier message du fil de discussion. |
get | String | Récupère l'ID de ce thread. |
get | Gmail | Renvoie les libellés créés par l'utilisateur sur ce thread. |
get | Date | Récupère la date du message le plus récent de ce fil de discussion. |
get | Integer | Renvoie le nombre de messages dans le fil de discussion. |
get | Gmail | Récupère les messages de ce fil de discussion. |
get | String | Récupère un lien permanent pour ce fil de discussion. |
has | Boolean | Indique si le fil de discussion contient des messages suivis. |
is | Boolean | Indique si le fil de discussion est marqué comme important. |
is | Boolean | Indique si le fil de discussion est marqué comme discussion. |
is | Boolean | Indique si le fil de discussion se trouve dans la boîte de réception. |
is | Boolean | Renvoie "true" si le fil de discussion se trouve dans la boîte de réception prioritaire, ou "false" dans le cas contraire. |
is | Boolean | Indique si le fil de discussion est marqué comme spam. |
is | Boolean | Indique si le fil de discussion se trouve dans la corbeille. |
is | Boolean | Indique si le fil de discussion contient des messages non lus. |
mark | Gmail | Ce fil de discussion a été marqué comme important. |
mark | Gmail | Marque ce fil de discussion comme lu. |
mark | Gmail | Marque ce fil de discussion comme non important. |
mark | Gmail | Marque ce fil de discussion comme non lu. |
move | Gmail | Déplace ce fil de discussion vers l'archive. |
move | Gmail | Déplace ce fil de discussion vers la boîte de réception. |
move | Gmail | Place ce fil de discussion dans le spam. |
move | Gmail | Place ce fil de discussion dans la corbeille. |
refresh() | Gmail | Recharge ce fil de discussion et l'état associé depuis Gmail (utile si les libellés, l'état de lecture, etc. ont changé). |
remove | Gmail | Supprime ce libellé du fil de discussion. |
reply(body) | Gmail | Répondez à l'expéditeur du dernier message de ce fil de discussion en utilisant l'adresse replyTo. |
reply(body, options) | Gmail | Répondez à l'expéditeur du dernier message de ce fil de discussion en utilisant l'adresse replyTo, avec des arguments facultatifs. |
reply | Gmail | Répondre à l'expéditeur (en utilisant l'adresse replyTo) et à tous les destinataires du dernier message de ce fil de discussion. |
reply | Gmail | Répondez à l'expéditeur (en utilisant l'adresse reply) et à tous les destinataires du dernier message de ce fil de discussion, avec des arguments facultatifs. |
Documentation détaillée
addLabel(label)
Ajoute ce libellé au fil de discussion.
// Add label MyLabel to the first thread in the inbox const label = GmailApp.getUserLabelByName('MyLabel'); const firstThread = GmailApp.getInboxThreads(0, 1)[0]; firstThread.addLabel(label);
Paramètres
| Nom | Type | Description |
|---|---|---|
label | Gmail | le libellé à appliquer à ce fil de discussion. |
Renvois
GmailThread : ce thread, utile pour le chaînage
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
createDraftReply(body)
Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion à l'aide de l'adresse de réponse. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.
// Create a draft reply to the message author with an acknowledgement. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; firstThread.createDraftReply('Got your message');
Paramètres
| Nom | Type | Description |
|---|---|---|
body | String | le corps de l'e-mail. |
Renvois
GmailDraft : le brouillon de message 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
createDraftReply(body, options)
Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion à l'aide de l'adresse de réponse, avec des arguments facultatifs.
L'e-mail peut contenir à la fois du texte brut et un corps HTML. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.
// Create a draft response with an HTML text body. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; firstThread.createDraftReply('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
Paramètres
| Nom | Type | Description |
|---|---|---|
body | String | le corps de l'e-mail. |
options | Object | Objet JavaScript qui spécifie des paramètres avancés, comme indiqué ci-dessous |
Paramètres avancés
| Nom | Type | Description |
|---|---|---|
attachments | Blob | Tableau de fichiers à envoyer avec l'e-mail |
bcc | String | Liste d'adresses e-mail à mettre en Cci, séparées par une virgule |
cc | String | Liste d'adresses e-mail à mettre en copie, séparées par une virgule. |
from | String | Adresse d'envoi de l'e-mail, qui doit être l'une des valeurs renvoyées par Gmail |
html | String | Si cette option est définie, les appareils capables d'afficher du code HTML l'utiliseront à la place de l'argument de corps requis. Vous pouvez ajouter un champ inline facultatif dans le corps HTML si vous avez intégré des images à votre e-mail. |
inline | Object | Objet JavaScript contenant un mappage 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, le nom de l'utilisateur) |
reply | String | Adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut : adresse e-mail de l'utilisateur) |
subject | String | un nouvel objet pour l'e-mail (250 caractères maximum) ; |
Renvois
GmailDraft : le brouillon de message 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
createDraftReplyAll(body)
Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion, en utilisant l'adresse de réponse et tous les destinataires de ce message. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.
// Create a draft reply to all recipients (except those bcc'd) of the last email // in this thread. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReplyAll('Got your message');
Paramètres
| Nom | Type | Description |
|---|---|---|
body | String | le corps de l'e-mail. |
Renvois
GmailDraft : le brouillon de message 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
createDraftReplyAll(body, options)
Crée un brouillon de message en réponse à l'expéditeur du dernier message de ce fil de discussion, en utilisant l'adresse de réponse et tous les destinataires, avec des arguments facultatifs.
L'e-mail peut contenir à la fois du texte brut et un corps HTML. La taille de l'e-mail (y compris les en-têtes) est limitée par un quota.
// Create a draft reply, using an HTML text body, to all recipients (except // those bcc'd) of the last email of in this thread. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; firstThread.createDraftReplyAll('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
Paramètres
| Nom | Type | Description |
|---|---|---|
body | String | le corps de l'e-mail. |
options | Object | Objet JavaScript qui spécifie des paramètres avancés, comme indiqué ci-dessous |
Paramètres avancés
| Nom | Type | Description |
|---|---|---|
attachments | Blob | Tableau de fichiers à envoyer avec l'e-mail |
bcc | String | Liste d'adresses e-mail à mettre en Cci, séparées par une virgule |
cc | String | Liste d'adresses e-mail à mettre en copie, séparées par une virgule. |
from | String | Adresse d'envoi de l'e-mail, qui doit être l'une des valeurs renvoyées par Gmail |
html | String | Si cette option est définie, les appareils capables d'afficher du code HTML l'utiliseront à la place de l'argument de corps requis. Vous pouvez ajouter un champ inline facultatif dans le corps HTML si vous avez intégré des images à votre e-mail. |
inline | Object | Objet JavaScript contenant un mappage 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, le nom de l'utilisateur) |
reply | String | Adresse e-mail à utiliser comme adresse de réponse par défaut (par défaut : adresse e-mail de l'utilisateur) |
subject | String | un nouvel objet pour l'e-mail. La taille maximale est de 250 caractères. |
Renvois
GmailDraft : le brouillon de message 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
getFirstMessageSubject()
Récupère l'objet du premier message du fil de discussion.
// Log the subject of the first message in the first thread in the inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; Logger.log(firstThread.getFirstMessageSubject());
Renvois
String : objet du premier message du 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
getId()
Récupère l'ID de ce thread. L'ID d'un thread varie en fonction des messages qu'il contient. Pour obtenir un ID cohérent pour un message spécifique du thread, appelez plutôt getMessages()[0].getId().
// Log the subject of the first message in the first thread in the inbox. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const id = firstThread.getId(); // Get same thread by its ID. const thread = GmailApp.getThreadById(id); Logger.log( thread.getFirstMessageSubject() === firstThread.getFirstMessageSubject(), ); // True
Renvois
String : ID de ce thread
getLabels()
Renvoie les libellés créés par l'utilisateur sur ce thread.
// Log the names of the labels attached to the first thread in the inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const labels = firstThread.getLabels(); for (let i = 0; i < labels.length; i++) { Logger.log(labels[i].getName()); }
Renvois
GmailLabel[] : tableau de libellés pour 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/
getLastMessageDate()
Récupère la date du message le plus récent de ce fil de discussion.
// Log the date of the most recent message on the first thread in the inbox const firstThread = GmailApp.getInboxThreads(0, 1)[0]; Logger.log(firstThread.getLastMessageDate());
Renvois
Date : date du message le plus récent du 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
getMessageCount()
Renvoie le nombre de messages dans le fil de discussion.
// Log the number of messages in the thread const firstThread = GmailApp.getInboxThreads(0, 1)[0]; Logger.log(firstThread.getMessageCount());
Renvois
Integer : nombre de messages dans le 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
getMessages()
Récupère les messages de ce fil de discussion.
// Log the subjects of the messages in the thread const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const messages = firstThread.getMessages(); for (let i = 0; i < messages.length; i++) { Logger.log(messages[i].getSubject()); }
Renvois
GmailMessage[] : un tableau de messages Gmail dans 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
getPermalink()
Obtient un lien permanent pour ce fil de discussion.
Notez que cela ne fonctionne qu'avec l'interface classique de Gmail, et non avec Inbox.
// Logs the permalink for the first thread in the inbox const thread =