Questa pagina è stata tradotta dall'API Cloud Translation.

Class GmailMessage

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/

`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

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

`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

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

`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

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

`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)

`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

forward(recipient)

`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

getTo()

`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

getSubject()

`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

getTo()

`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

getReplyTo()

`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

getSubject()

`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

getCc()

`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

getAttachments()

`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

getCc()

`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

isUnread()

`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

isUnread()

`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

isInTrash()

`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)
replyAll(body)
replyAll(body, options)

`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

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

`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

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

`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

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

`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()

`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/

Vedi anche

star()