Class GmailApp

Crea una bozza di messaggio email. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla 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()}`,
);

Parametri

Invio

GmailDraft: la bozza di Gmail appena creata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• createDraft(recipient, subject, body, options)

Crea una bozza di messaggio email con argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. Le dimensioni dell'email (incluse le intestazioni, ma esclusi gli allegati) sono limitate.

// 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',
    },
);

Parametri

Parametri avanzati

Invio

GmailDraft: la bozza di Gmail appena creata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• createDraft(recipient, subject, body)

Crea una nuova etichetta utente con il nome specificato.

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

Parametri

Invio

GmailLabel: l'etichetta appena creata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• deleteLabel(label)

Consente di eliminare l'etichetta specificata.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• createLabel(name)

Restituisce un elenco delle email configurate come alias per questo account in Gmail.

Puoi inviare un messaggio da uno di questi alias utilizzando l'argomento facoltativo "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.');
}

Invio

String[]: un array di alias per questo account

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• sendEmail(recipient, subject, body, options)

Recupera una bozza di messaggio email per ID.

Utilizzalo in combinazione con getId() nelle bozze di 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(),
);

Parametri

Invio

GmailDraft: la bozza con l'ID specificato

Lanci

Error: se non è possibile trovare una bozza con l'ID specificato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera tutte le bozze dei messaggi.

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

Invio

GmailMessage[]: un array di bozze di messaggi Gmail

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera tutte le bozze dei messaggi di Gmail.

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

Invio

GmailDraft[]: un array di bozze di messaggi Gmail

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera tutti i thread della Posta in arrivo, indipendentemente dalle etichette.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

GmailThread[]: un array di thread di Gmail nella Posta in arrivo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un intervallo di thread della Posta in arrivo, indipendentemente dalle etichette.

// 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());
}

Parametri

Invio

GmailThread[]: un array di thread di Gmail nella Posta in arrivo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera il numero di thread da leggere nella Posta in arrivo.

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

Invio

Integer: il numero di thread nella Posta in arrivo con messaggi da leggere

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un messaggio per ID.

Utilizzalo in combinazione con getId() sui messaggi 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());

Parametri

Invio

GmailMessage: il messaggio con l'ID specificato

Lanci

Error: se non è possibile trovare alcun messaggio con l'ID specificato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• getThreadById(id)

Recupera tutti i messaggi nel thread specificato.

// 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()}`);
}

Parametri

Invio

GmailMessage[]: array di messaggi corrispondenti a questo thread

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• getMessagesForThreads(threads)

Recupera tutti i messaggi nei thread specificati.

// 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()}`);
  }
}

Parametri

Invio

GmailMessage[][]: un array di array di messaggi, in cui ogni elemento dell'array esterno corrisponde a un thread e l'array interno contiene i messaggi del thread

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• getMessagesForThread(thread)

Recupera tutti i thread della Posta in arrivo prioritaria, indipendentemente dalle etichette.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

GmailThread[]: un array di thread di Gmail nella Posta prioritaria

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera una serie di thread della Posta prioritaria indipendentemente dalle etichette.

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

Parametri

Invio

GmailThread[]: un array di thread di Gmail nella Posta prioritaria

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera il numero di thread non letti nella Posta prioritaria.

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

Invio

Integer: il numero di thread nella Posta prioritaria con messaggi da leggere

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera tutti i thread di spam, indipendentemente dalle etichette.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

GmailThread[]: un array di thread di Gmail nella cartella Spam

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera una serie di thread di spam indipendentemente dalle etichette.

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

Parametri

Invio

GmailThread[]: un array di thread di Gmail nella cartella Spam

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Restituisce il numero di thread da leggere che sono 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()}`);

Invio

Integer: il numero di thread di spam con messaggi da leggere

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera tutti i thread contrassegnati come speciali, indipendentemente dalle etichette.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

GmailThread[]: un array di thread di Gmail aggiunti a Speciali

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un intervallo di thread contrassegnati come preferiti, indipendentemente dalle etichette.

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

Parametri

Invio

GmailThread[]: un array di thread di Gmail aggiunti a Speciali

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera il numero di thread contrassegnati con l'icona a forma di stella non letti.

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

Invio

Integer: il numero di thread aggiunti a Speciali con messaggi non letti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un thread tramite ID.

Utilizzalo in combinazione con getId() nei thread di 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(),
);

Parametri

Invio

GmailThread: il thread con l'ID specificato o null se non viene trovato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• getMessageById(id)

Recupera tutti i thread cestino, indipendentemente dalle etichette.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

GmailThread[]: un array di thread di Gmail nel cestino

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un intervallo di thread cestino indipendentemente dalle etichette.

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

Parametri

Invio

GmailThread[]: un array di thread di Gmail nel cestino

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un'etichetta in base al nome.

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

Parametri

Invio

GmailLabel: l'etichetta Gmail con il nome specificato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un elenco di etichette create dall'utente.

// 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()}`);
}

Invio

GmailLabel[]: array di etichette create dall'utente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Contrassegna il messaggio come letto e forza l'aggiornamento del messaggio.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markMessageUnread(message)

Contrassegna il messaggio come da leggere e forza l'aggiornamento del messaggio.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markMessageRead(message)

Contrassegni questi messaggi come letti e forza il loro aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markMessagesUnread(messages)

Contrassegni questi messaggi come da leggere e forza il loro aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markMessagesRead(messages)

Contrassegni questo thread come importante e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadUnimportant(thread)

Contrassegni questo thread come letto e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadUnread(thread)

Contrassegni questo thread come non importante e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadImportant(thread)

Contrassegni questo thread come da leggere e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadRead(thread)

Contrassegni questi thread come importanti e forza il loro aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadsUnimportant(threads)

Contrassegni questi thread come letti e forza il loro aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadsUnread(threads)

Contrassegni questi thread come non importanti e forza il loro aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadsImportant(threads)

Contrassegni questi thread come da leggere e forza il loro aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• markThreadsRead(threads)

Sposta il messaggio nel cestino e forza l'aggiornamento del messaggio.

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

Parametri

Invio

GmailApp: il servizio Gmail (utile per l'accodamento)

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• moveMessagesToTrash(messages)

Sposta i messaggi specificati nel cestino e forza il loro aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail (utile per l'accodamento)

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• moveMessageToTrash(message)

Sposta questo thread nell'archivio e ne forza l'aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questo thread nella Posta in arrivo e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questo thread nella cartella Spam e forza l'aggiornamento.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta il thread nel cestino e forza l'aggiornamento del thread.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questi thread nell'archivio e li aggiorna forzatamente.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questi thread nella posta in arrivo e li aggiorna forzatamente.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questi thread nella cartella Spam e li aggiorna forzatamente.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Sposta questi thread nel cestino e li forza a aggiornarsi.

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

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

Ricarica il messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).

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...

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• refreshMessages(messages)

Ricarica i messaggi e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).

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...

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• refreshMessage(message)

Ricarica il thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• refreshThreads(threads)

Ricarica i thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura e così via siano cambiati).

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

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• refreshThread(thread)

Cerca in Gmail con la query specificata.

Questa chiamata non andrà a buon fine se le dimensioni di tutti i thread sono troppo grandi per essere gestite dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza la chiamata "paginata" e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Parametri

Invio

GmailThread[]: un array di thread di Gmail corrispondenti a questa query

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Cerca in Gmail con la query specificata.

// 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);

Parametri

Invio

GmailThread[]: un array di thread di Gmail corrispondenti a questa query

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Invia un messaggio email. Le dimensioni dell'email (incluse le intestazioni) sono limitate dalla 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()}`,
);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• sendEmail(recipient, subject, body, options)

Invia un messaggio email con argomenti facoltativi. L'email può contenere testo normale o un corpo HTML. Le dimensioni dell'email (incluse le intestazioni, ma esclusi gli allegati) sono soggette a limiti di 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',
    },
);

Parametri

Parametri avanzati

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• sendEmail(recipient, subject, body)

Imposta il token di accesso al messaggio corrente che consente allo script di accedere alle proprietà GmailMessage correnti.

Solo i progetti di componenti aggiuntivi di Google Workspace che utilizzano gli ambiti attuali dei messaggi di Gmail richiedono questo metodo.

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

Parametri

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Aggiunge una stella a questo messaggio e ne forza l'aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• starMessages(messages)

Aggiunge le stelle a questi messaggi e ne forza l'aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• starMessage(message)

Rimuove una stella da questo messaggio e forza l'aggiornamento del messaggio.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• unstarMessages(messages)

Rimuove le stelle da questi messaggi e ne forza l'aggiornamento.

// 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);

Parametri

Invio

GmailApp: il servizio Gmail, utile per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• unstarMessage(message)