Un messaggio nell'account Gmail di un utente.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
createDraftReply(body) | GmailDraft | Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per risposte. |
createDraftReply(body, options) | GmailDraft | Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per le risposte, con argomenti facoltativi. |
createDraftReplyAll(body) | GmailDraft | Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo per le risposte e tutti i destinatari del messaggio. |
createDraftReplyAll(body, options) | GmailDraft | Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi. |
forward(recipient) | GmailMessage | Inoltra questo messaggio ai nuovi destinatari. |
forward(recipient, options) | GmailMessage | Inoltra questo messaggio ai nuovi destinatari, con argomenti facoltativi. |
getAttachments() | GmailAttachment[] | Recupera tutti gli allegati per questo messaggio. |
getAttachments(options) | GmailAttachment[] | Recupera tutti gli allegati per questo messaggio. |
getBcc() | String | Restituisce i destinatari separati da virgole in Ccn in questo messaggio. |
getBody() | String | Restituisce i contenuti HTML del corpo di questo messaggio. |
getCc() | String | Restituisce i destinatari separati da virgole in copia in questo messaggio. |
getDate() | Date | Consente di acquisire la data e l'ora di questo messaggio. |
getFrom() | String | Recupera il mittente di questo messaggio. |
getHeader(name) | String | Restituisce il valore di un'intestazione RFC 2822 dato il nome dell'intestazione. |
getId() | String | Consente di acquisire l'ID di questo messaggio. |
getPlainBody() | String | Restituisce i contenuti del corpo di questo messaggio senza formattazione HTML. |
getRawContent() | String | Recupera i contenuti non elaborati di questo messaggio. |
getReplyTo() | String | Recupera l'indirizzo per risposte del messaggio (di solito il mittente). |
getSubject() | String | Recupera l'oggetto di questo messaggio. |
getThread() | GmailThread | Recupera il thread che contiene il messaggio. |
getTo() | String | Restituisce i destinatari separati da virgole di questo messaggio. |
isDraft() | Boolean | Riconosce se il messaggio è una bozza. |
isInChats() | Boolean | Riconosce se questo messaggio è una chat. |
isInInbox() | Boolean | Riconosce se questo messaggio si trova nella Posta in arrivo. |
isInPriorityInbox() | Boolean | Restituisce true se il messaggio si trova nella Posta prioritaria; in caso contrario restituisce false . |
isInTrash() | Boolean | Riconosce se il messaggio è nel cestino. |
isStarred() | Boolean | Riconosce se il messaggio è stato aggiunto a Speciali. |
isUnread() | Boolean | Riconosce se questo messaggio non è letto. |
markRead() | GmailMessage | Contrassegna il messaggio come letto. |
markUnread() | GmailMessage | Contrassegna il messaggio come da leggere. |
moveToTrash() | GmailMessage | Sposta il messaggio nel cestino. |
refresh() | GmailMessage | Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati). |
reply(body) | GmailMessage | Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte. |
reply(body, options) | GmailMessage | Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte, con argomenti facoltativi. |
replyAll(body) | GmailMessage | Risponde al mittente utilizzando l'indirizzo per risposte e tutti i destinatari di questo messaggio. |
replyAll(body, options) | GmailMessage | Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi. |
star() | GmailMessage | Aggiungi il messaggio a Speciali. |
unstar() | GmailMessage | Rimuove il messaggio da Speciali. |
Documentazione dettagliata
createDraftReply(body)
Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per risposte. Le dimensioni dell'email (incluse le intestazioni) sono quota limitata.
// 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");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
Ritorni
GmailDraft
: la bozza del messaggio appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
createDraftReply(body, options)
Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per le risposte, con argomenti facoltativi.
L'email può contenere sia testo normale sia un corpo HTML. La dimensione dell'email (incluse le intestazioni) è quota limitata.
// 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" });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di eseguire il rendering del codice HTML lo utilizzeranno al posto dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente). |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
subject | String | Una nuova riga dell'oggetto dell'email, fino a un massimo di 250 caratteri. |
Ritorni
GmailDraft
: la bozza del messaggio appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
createDraftReplyAll(body)
Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo per le risposte e tutti i destinatari del messaggio. La dimensione dell'email (incluse le intestazioni) è una quota limitata.
// 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");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
Ritorni
GmailDraft
: la bozza del messaggio appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
createDraftReplyAll(body, options)
Crea una bozza di messaggio per rispondere al mittente del messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.
L'email può contenere sia testo normale sia un corpo HTML. La dimensione dell'email (incluse le intestazioni) è quota limitata.
// 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" });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di eseguire il rendering del codice HTML lo utilizzeranno al posto dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente). |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
subject | String | Una nuova riga dell'oggetto dell'email, fino a un massimo di 250 caratteri. |
Ritorni
GmailDraft
: la bozza del messaggio appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
forward(recipient)
Inoltra questo messaggio ai nuovi destinatari. La dimensione dell'email (incluse le intestazioni) è una quota limitata.
// 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");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | Un elenco di indirizzi email separati da virgole. |
Ritorni
GmailMessage
: questo messaggio, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
forward(recipient, options)
Inoltra questo messaggio ai nuovi destinatari, con argomenti facoltativi.
L'email può contenere sia testo normale sia un corpo HTML. La dimensione dell'email (incluse le intestazioni) è limitata in base alla quota.
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" });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
recipient | String | Un elenco di indirizzi email separati da virgole. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di eseguire il rendering del codice HTML lo utilizzeranno al posto dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente). |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
subject | String | Una nuova riga dell'oggetto dell'email, fino a un massimo di 250 caratteri. |
Ritorni
GmailMessage
: questo messaggio, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getAttachments()
Recupera tutti gli allegati per questo messaggio.
Ritorni
GmailAttachment[]
: un array di allegati BLOB per questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getAttachments(options)
Recupera tutti gli allegati per questo messaggio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
includeInlineImages | Boolean | true se l'array restituito degli allegati Blob
deve includere immagini incorporate (il valore predefinito è true ). |
includeAttachments | Boolean | true se l'array restituito degli allegati Blob
deve includere allegati regolari (non in linea) (il valore predefinito è true ). |
Ritorni
GmailAttachment[]
: un array di allegati BLOB per questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getBcc()
Restituisce i destinatari separati da virgole in Ccn in questo messaggio.
Questo campo è vuoto per tutti i messaggi ricevuti, per definizione.
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
Ritorni
String
: i destinatari separati da virgole in Ccn in questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getBody()
Restituisce i contenuti HTML del corpo di questo messaggio.
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
Ritorni
String
: il contenuto del corpo di questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getCc()
Restituisce i destinatari separati da virgole in copia in questo messaggio.
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
Ritorni
String
: i destinatari separati da virgole inseriti in Cc nel messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getDate()
Consente di acquisire la data e l'ora di questo messaggio.
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
Ritorni
Date
: data e ora del messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getFrom()
Recupera il mittente di questo messaggio.
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
Ritorni
String
: l'indirizzo email del mittente del messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getHeader(name)
Restituisce il valore di un'intestazione RFC 2822 dato il nome dell'intestazione.
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.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome dell'intestazione RFC, senza i due punti che la separano dal valore. |
Ritorni
String
: il valore dell'intestazione o una stringa vuota se l'intestazione non esiste nel messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getId()
Consente di acquisire l'ID di questo messaggio.
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
Ritorni
String
: l'ID del messaggio.
getPlainBody()
Restituisce i contenuti del corpo di questo messaggio senza formattazione HTML. Questa operazione è più complessa di
getBody()
e richiede più tempo.
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
Ritorni
String
: i contenuti del corpo normale del messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getRawContent()
Recupera i contenuti non elaborati di questo messaggio. Equivale a "Mostra originale" nell'interfaccia utente di Gmail.
Ritorni
String
: i contenuti non elaborati del messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getReplyTo()
Recupera l'indirizzo per risposte del messaggio (di solito il mittente).
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
Ritorni
String
: l'indirizzo email a cui rispondere.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getSubject()
Recupera l'oggetto di questo messaggio.
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
Ritorni
String
: l'oggetto di questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
getThread()
Recupera il thread che contiene il messaggio.
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
Ritorni
GmailThread
: il thread di Gmail che contiene il messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
getTo()
Restituisce i destinatari separati da virgole di questo messaggio.
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
Ritorni
String
: i destinatari del messaggio separati da virgole.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
isDraft()
Riconosce se il messaggio è una bozza.
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());
Ritorni
Boolean
: indica se il messaggio è una bozza.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
isInChats()
Riconosce se questo messaggio è una 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());
Ritorni
Boolean
: indica se si tratta di un messaggio di chat.
isInInbox()
Riconosce se questo messaggio si trova nella Posta in arrivo.
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());
Ritorni
Boolean
: indica se il messaggio si trova nella Posta in arrivo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
isInPriorityInbox()
Restituisce true
se il messaggio si trova nella Posta prioritaria; in caso contrario restituisce false
.
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()); }
Ritorni
Boolean
: indica se il messaggio si trova nella Posta prioritaria.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
isInTrash()
Riconosce se il messaggio è nel cestino.
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());
Ritorni
Boolean
: indica se il messaggio è nel cestino.
isStarred()
Riconosce se il messaggio è stato aggiunto a Speciali.
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());
Ritorni
Boolean
: indica se il messaggio è stato aggiunto a Speciali.
isUnread()
Riconosce se questo messaggio non è letto.
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());
Ritorni
Boolean
: lo stato da leggere di questo messaggio.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
markRead()
Contrassegna il messaggio come letto.
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
Ritorni
GmailMessage
- Questo messaggio di Gmail, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
markUnread()
Contrassegna il messaggio come da leggere.
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
Ritorni
GmailMessage
- Questo messaggio di Gmail, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
moveToTrash()
Sposta il messaggio nel cestino.
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
Ritorni
GmailMessage
- Questo messaggio di Gmail, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
refresh()
Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).
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
Ritorni
GmailMessage
: questo messaggio per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
reply(body)
Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte. La dimensione dell'email (incluse le intestazioni) è limitata in base alla quota.
// Respond to author of message with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.reply("Got your message");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
Ritorni
GmailMessage
: questo messaggio, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
reply(body, options)
Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte, con argomenti facoltativi.
L'email può contenere sia testo normale sia un corpo HTML. La dimensione dell'email (incluse le intestazioni) è limitata in base alla quota.
// 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 });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di eseguire il rendering del codice HTML lo utilizzeranno al posto dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente). |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
subject | String | Una nuova riga dell'oggetto dell'email, fino a un massimo di 250 caratteri. |
Ritorni
GmailMessage
: questo messaggio, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
replyAll(body)
Risponde al mittente utilizzando l'indirizzo per risposte e tutti i destinatari di questo messaggio. Le dimensioni dell'email (incluse le intestazioni) sono limitate in base alla 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");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
Ritorni
GmailMessage
: questo messaggio,utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
replyAll(body, options)
Risponde al mittente di questo messaggio utilizzando l'indirizzo per risposte e tutti i destinatari, con argomenti facoltativi.
L'email può contenere sia testo normale sia un corpo HTML. La dimensione dell'email (incluse le intestazioni) è limitata in base alla quota.
// 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 });
Parametri
Nome | Tipo | Descrizione |
---|---|---|
body | String | Il corpo dell'email. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
attachments | BlobSource[] | un array di file da inviare con l'email |
bcc | String | un elenco separato da virgole di indirizzi email in Ccn |
cc | String | un elenco di indirizzi email da mettere in copia separati da virgole |
from | String | l'indirizzo da cui deve essere inviata l'email, che deve essere uno dei valori restituiti da GmailApp.getAliases() |
htmlBody | String | se impostato, i dispositivi in grado di eseguire il rendering del codice HTML lo utilizzeranno al posto dell'argomento body richiesto; puoi aggiungere un campo inlineImages facoltativo nel corpo HTML se per la tua email sono presenti immagini incorporate |
inlineImages | Object | un oggetto JavaScript contenente una mappatura dalla chiave dell'immagine (String ) ai dati dell'immagine (BlobSource ); questo presuppone che venga utilizzato il parametro htmlBody e contenga riferimenti a queste immagini nel formato <img src="cid:imageKey" /> |
name | String | Il nome del mittente dell'email (impostazione predefinita: il nome dell'utente). |
noReply | Boolean | true se l'email deve essere inviata da un indirizzo email generico non abilitato alle risposte per scoraggiare i destinatari dal rispondere alle email. Questa opzione è disponibile solo per gli account Google Workspace, non per gli utenti di Gmail. |
replyTo | String | Un indirizzo email da utilizzare come indirizzo per le risposte predefinito (impostazione predefinita: l'indirizzo email dell'utente) |
subject | String | Una nuova riga dell'oggetto dell'email, fino a un massimo di 250 caratteri. |
Ritorni
GmailMessage
: questo messaggio, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
star()
Aggiungi il messaggio a Speciali.
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
Ritorni
GmailMessage
- Questo messaggio di Gmail, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/
Vedi anche
unstar()
Rimuove il messaggio da Speciali.
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
Ritorni
GmailMessage
- Questo messaggio di Gmail, utile per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://mail.google.com/