Class GmailApp

Erstellt einen Entwurf für eine E-Mail-Nachricht. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());

Parameter

Rückflug

GmailDraft: der neu erstellte GmailDraft

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• createDraft(recipient, subject, body, options)

Erstellt einen Entwurf für eine E-Mail-Nachricht mit optionalen Argumenten. Die E-Mail kann reinen Text oder HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header, aber ohne Anhänge) ist auf ein Kontingent begrenzt.

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

Parameter

Erweiterte Parameter

Rückflug

GmailDraft: der neu erstellte GmailDraft

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• createDraft(recipient, subject, body)

Erstellt ein neues Nutzerlabel mit dem angegebenen Namen.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Parameter

Rückflug

GmailLabel: das neu erstellte Label

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• deleteLabel(label)

Löscht das angegebene Label

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• createLabel(name)

Ruft eine Liste der E-Mail-Adressen ab, die als Alias für dieses Konto in Gmail eingerichtet sind

Sie können eine Nachricht von jedem dieser Aliasse senden, indem Sie das optionale Argument "from" verwenden.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var 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.');
}

Rückflug

String[]: ein Array von Aliassen für dieses Konto

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• sendEmail(recipient, subject, body, options)

E-Mail-Entwurf nach ID abrufen

Verwenden Sie dies in Verbindung mit getId() für Gmail-Entwürfe.

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

Parameter

Rückflug

GmailDraft: der Entwurf mit der angegebenen ID

Löst aus

Error, wenn kein Entwurf mit der angegebenen ID gefunden werden kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Entwürfe ab.

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

Rückflug

GmailMessage[]: ein Array von Gmail-Entwürfen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Gmail-Entwürfe ab

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

Rückflug

GmailDraft[]: ein Array mit Gmail-Entwürfen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Posteingangsthreads unabhängig von den Labels ab

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

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

Rückflug

GmailThread[]: ein Array von Gmail-Threads im Posteingang

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich von Posteingangsthreads unabhängig von den Labels ab

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

Parameter

Rückflug

GmailThread[]: ein Array von Gmail-Threads im Posteingang

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Threads im Posteingang ab

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Rückflug

Integer: die Anzahl der Threads im Posteingang mit ungelesenen Nachrichten

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Nachricht nach ID ab.

Verwenden Sie dies in Verbindung mit getId() für Gmail-Nachrichten.

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

Parameter

Rückflug

GmailMessage: die Nachricht mit der angegebenen ID

Löst aus

Error, wenn keine Nachricht mit der angegebenen ID gefunden werden kann

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getThreadById(id)

Ruft alle Nachrichten im angegebenen Thread ab

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

Parameter

Rückflug

GmailMessage[]: Array der Nachrichten für diesen Thread

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessagesForThreads(threads)

Ruft alle Nachrichten in den angegebenen Threads ab

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

Parameter

Rückflug

GmailMessage[][]: ein Array von Nachrichtenarrays, wobei jedes Element im äußeren Array einem Thread entspricht und das innere Array die Nachrichten in diesem Thread enthält

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessagesForThread(thread)

Ruft alle Threads im sortierten Eingang unabhängig von den Labels ab

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Rückflug

GmailThread[]: ein Array von Gmail-Threads im sortierten Eingang

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich von Threads im Sortierten Eingang unabhängig von den Labels ab

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

Parameter

Rückflug

GmailThread[]: ein Array von Gmail-Threads im sortierten Eingang

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Threads im sortierten Eingang ab.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Rückflug

Integer: die Anzahl der Threads im sortierten Eingang mit ungelesenen Nachrichten

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Spam-Threads unabhängig von den Labels ab

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Rückflug

GmailThread[]: Eine Reihe von Gmail-Threads im Spamordner

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Reihe von Spam-Threads unabhängig von den Labels ab

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

Parameter

Rückflug

GmailThread[]: Eine Reihe von Gmail-Threads im Spamordner

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Threads ab, die Spam sind.

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

Rückflug

Integer: die Anzahl der Spam-Threads mit ungelesenen Nachrichten

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle markierten Threads unabhängig von den Labels ab

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Rückflug

GmailThread[]: ein Array markierter Gmail-Threads

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich markierter Threads unabhängig von den Labels ab

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

Parameter

Rückflug

GmailThread[]: ein Array markierter Gmail-Threads

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Threads ab, die markiert sind.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Rückflug

Integer: die Anzahl der markierten Threads mit ungelesenen Nachrichten

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Thread nach ID ab.

Verwenden Sie dies in Verbindung mit getId() für Gmail-Threads.

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

Parameter

Rückflug

GmailThread: Der Thread mit der angegebenen ID oder null, falls nicht gefunden.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessageById(id)

Ruft alle Papierkorb-Threads unabhängig von den Labels ab

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Rückflug

GmailThread[]: ein Array von Gmail-Threads im Papierkorb

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich von Papierkorb-Threads unabhängig von den Labels ab

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

Parameter

Rückflug

GmailThread[]: ein Array von Gmail-Threads im Papierkorb

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft ein Label mit dem Labelnamen ab

var labelObject = GmailApp.getUserLabelByName("myLabel");

Parameter

Rückflug

GmailLabel: das Gmail-Label mit dem angegebenen Namen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Liste der von Nutzern erstellten Labels ab

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

Rückflug

GmailLabel[]: Array der von Nutzern erstellten Labels

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Diese Nachricht wird als gelesen markiert und erzwingt die Aktualisierung der Nachricht.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessageUnread(message)

Die Nachricht wird als ungelesen markiert und eine Aktualisierung der Nachricht erzwungen.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessageRead(message)

Diese Nachrichten werden als gelesen markiert und erzwingt eine Aktualisierung der Nachrichten.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessagesUnread(messages)

Diese Nachrichten werden als ungelesen markiert und eine Aktualisierung der Nachrichten erzwungen.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessagesRead(messages)

Kennzeichnet diesen Thread als wichtig und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadUnimportant(thread)

Kennzeichnet diesen Thread als gelesen und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadUnread(thread)

Kennzeichnet diesen Thread als unwichtig und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadImportant(thread)

Markiert diesen Thread als ungelesen und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadRead(thread)

Kennzeichnet diese Threads als wichtig und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsUnimportant(threads)

Markiert diese Threads als gelesen und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsUnread(threads)

Markiert diese Threads als unwichtig und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsImportant(threads)

Dadurch werden diese Threads als ungelesen markiert und die Aktualisierung der Threads erzwungen.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsRead(threads)

Die Nachricht wird in den Papierkorb verschoben und die Aktualisierung wird erzwungen.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst (nützlich für Verkettungen)

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• moveMessagesToTrash(messages)

Die angegebenen Nachrichten werden in den Papierkorb verschoben und die Nachrichten werden aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst (nützlich für Verkettungen)

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• moveMessageToTrash(message)

Verschiebt diesen Thread in das Archiv und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diesen Thread in den Posteingang und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diesen Thread in den Spamordner und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diesen Thread in den Papierkorb und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diese Threads in das Archiv und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diese Threads in den Posteingang und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Diese Threads werden in den Spamordner verschoben und die Threads werden aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diese Threads in den Papierkorb und erzwingt eine Aktualisierung der Threads.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Die Nachricht und der zugehörige Status aus Gmail werden neu geladen. Dies ist nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshMessages(messages)

Die Nachrichten und der zugehörige Status aus Gmail werden neu geladen. Dies ist nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshMessage(message)

Der Thread und der zugehörige Status werden aus Gmail neu geladen. Dies ist nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshThreads(threads)

Die Threads und der zugehörige Status werden aus Gmail neu geladen. Das ist nützlich, wenn sich Labels, der Lesestatus usw. geändert haben.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshThread(thread)

Suchen Sie in Gmail mit der angegebenen Abfrage.

Dieser Aufruf schlägt fehl, wenn alle Threads zu groß für das System sind. Wenn die Thread-Größe unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie Bereiche der Threads an, die bei jedem Aufruf abgerufen werden sollen.

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

Parameter

Rückflug

GmailThread[]: ein Array von Gmail-Threads, die dieser Abfrage entsprechen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Suchen Sie in Gmail mit der angegebenen Abfrage.

// 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.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Parameter

Rückflug

GmailThread[]: ein Array von Gmail-Threads, die dieser Abfrage entsprechen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Sendet eine E-Mail-Nachricht. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("mike@example.com", "current time", "The time is: " + now.toString());

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• sendEmail(recipient, subject, body, options)

Sendet eine E-Mail-Nachricht mit optionalen Argumenten. Die E-Mail kann reinen Text oder HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header, aber ohne Anhänge) ist auf ein Kontingent begrenzt.

// Send an email with a file from Google Drive attached as a PDF.
var 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'
});

Parameter

Erweiterte Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• sendEmail(recipient, subject, body)

Legt das aktuelle Zugriffstoken für die Nachricht fest, mit dem das Skript auf die aktuellen GmailMessage-Attribute zugreifen kann.

Diese Methode ist nur für Google Workspace-Add-on-Projekte erforderlich, in denen die aktuellen Nachrichtenbereiche von Gmail verwendet werden.

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

Parameter

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Die Nachricht wird mit einem Stern markiert und die Nachricht wird aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• starMessages(messages)

Diese Nachrichten werden mit einem Stern markiert und die Nachrichten werden aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• starMessage(message)

Die Nachricht wird nicht mit einem Stern markiert und die Nachricht wird aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• unstarMessages(messages)

Diese Nachrichten werden mit einem Stern markiert und die Nachrichten werden aktualisiert.

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

Parameter

Rückflug

GmailApp: der Gmail-Dienst, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechender Bereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• unstarMessage(message)