Class GmailApp

Erstellt einen E‑Mail-Entwurf. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

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

Parameter

Rückflug

GmailDraft – der neu erstellte Gmail-Entwurf

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• createDraft(recipient, subject, body, options)

Erstellt eine E‑Mail-Nachricht als Entwurf mit optionalen Argumenten. Die E‑Mail kann Nur-Text oder einen HTML-Text enthalten. Die Größe der E‑Mail (einschließlich Kopfzeilen, aber ohne Anhänge) ist kontingentbeschränkt.

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

Parameter

Erweiterte Parameter

Rückflug

GmailDraft – der neu erstellte Gmail-Entwurf

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const label = GmailApp.getUserLabelByName('FOO');
GmailApp.deleteLabel(label);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• createLabel(name)

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

Sie können eine Nachricht von einem dieser Aliase aus senden, indem Sie das optionale Argument „from“ verwenden.

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

Rückflug

String[]: Ein Array von Aliasen für dieses Konto

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• sendEmail(recipient, subject, body, options)

E‑Mail-Entwurf anhand der ID abrufen

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

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

Parameter

Rückflug

GmailDraft: der Entwurf mit der angegebenen ID

Löst

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle E‑Mail-Entwürfe ab.

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

Rückflug

GmailMessage[] – ein Array mit Gmail-Nachrichtentwürfen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Gmail-Nachrichtenentwürfe ab.

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

Rückflug

GmailDraft[] – ein Array von Gmail-Nachrichtenentwürfen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Inbox-Konversationen unabhängig von Labels ab.

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen im Posteingang

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

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

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

Parameter

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen im Posteingang

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 Unterhaltungen im Posteingang, die ungelesene Nachrichten enthalten

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Nachricht anhand der ID ab.

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

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

Parameter

Rückflug

GmailMessage: die Nachricht mit der angegebenen ID

Löst

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getThreadById(id)

Alle Nachrichten im angegebenen Thread abrufen.

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

Parameter

Rückflug

GmailMessage[] – Array von Nachrichten, die dieser Unterhaltung entsprechen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessagesForThreads(threads)

Alle Nachrichten in den angegebenen Threads abrufen.

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

Parameter

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessagesForThread(thread)

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

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen im sortierten Eingang

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Reihe von Konversationen im sortierten Eingang unabhängig von 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-Konversationen im sortierten Eingang

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Unterhaltungen im sortierten Eingang ab.

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

Rückflug

Integer: Die Anzahl der Unterhaltungen im Posteingang mit Priorität, die ungelesene Nachrichten enthalten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle Spam-Konversationen unabhängig von Labels ab.

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen im Spamordner

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich von Spam-Threads unabhängig von Labels ab.

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

Parameter

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen im Spamordner

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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: Anzahl der Spam-Konversationen mit ungelesenen Nachrichten

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft alle mit Sternchen markierten Threads unabhängig von Labels ab.

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Rückflug

GmailThread[] – ein Array mit markierten Gmail-Konversationen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich mit markierten Threads unabhängig von 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 mit markierten Gmail-Konversationen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft die Anzahl der ungelesenen Threads ab, die mit einem Sternchen markiert sind.

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

Rückflug

Integer: Anzahl der markierten Unterhaltungen mit ungelesenen Nachrichten

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Thread nach ID ab.

Wird in Verbindung mit getId() für Gmail-Unterhaltungen verwendet.

// 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|null – Der Thread mit der angegebenen ID oder null, falls er nicht gefunden wurde.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessageById(id)

Ruft alle Threads im Papierkorb unabhängig von Labels ab.

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft einen Bereich von gelöschten Threads unabhängig von 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft ein Label anhand des Labelnamens ab.

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

Parameter

Rückflug

GmailLabel: Das Gmail-Label mit dem angegebenen Namen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Ruft eine Liste der vom Nutzer erstellten Labels ab.

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

Rückflug

GmailLabel[] – Array mit vom Nutzer erstellten Labels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Diese Nachricht wird als gelesen markiert und die Nachricht wird aktualisiert.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessageUnread(message)

Diese Nachricht wird als ungelesen markiert und die Nachricht wird aktualisiert.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessageRead(message)

Markiert diese Nachrichten als gelesen 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.
const threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
const messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(messages);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessagesUnread(messages)

Markiert diese Nachrichten als ungelesen und erzwingt eine Aktualisierung der Nachrichten.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markMessagesRead(messages)

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

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadUnimportant(thread)

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

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadUnread(thread)

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

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadRead(thread)

Markiert diese Threads als wichtig und erzwingt, dass sie aktualisiert werden.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsUnimportant(threads)

Diese Threads werden als gelesen markiert und aktualisiert.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsUnread(threads)

Markiert diese Threads als unwichtig und erzwingt, dass sie aktualisiert werden.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsImportant(threads)

Diese Threads werden als ungelesen markiert und aktualisiert.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markThreadsRead(threads)

Verschiebt die Nachricht in den Papierkorb und erzwingt eine Aktualisierung der Nachricht.

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

Parameter

Rückflug

GmailApp – der Gmail-Dienst (nützlich für die Verkettung)

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• moveMessagesToTrash(messages)

Verschiebt die angegebenen Nachrichten in den Papierkorb und erzwingt eine Aktualisierung der Nachrichten.

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

Parameter

Rückflug

GmailApp – der Gmail-Dienst (nützlich für die Verkettung)

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• moveMessageToTrash(message)

Verschiebt diesen Thread ins Archiv und erzwingt eine Aktualisierung des Threads.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const thread = GmailApp.search('-in:inbox')[0];  // Get the first one
GmailApp.moveThreadToInbox(thread);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToSpam(firstThread);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToTrash(firstThread);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Verschiebt diese Threads ins Archiv und erzwingt, dass die Threads aktualisiert werden.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const firstTwoThreads = GmailApp.search('-in:inbox', 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

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

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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
const firstTwoThreads = GmailApp.getInboxThreads(0, 2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Lädt die Nachricht und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben).

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshMessages(messages)

Lädt die Nachrichten und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben).

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshMessage(message)

Lädt den Thread und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben).

const 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, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshThreads(threads)

Lädt die Threads und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben).

const 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, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• refreshThread(thread)

Suchen Sie in Gmail mit der angegebenen Anfrage.

Dieser Aufruf schlägt fehl, wenn die Größe aller Threads zu groß für das System ist. Wenn die Threadgröße unbekannt und möglicherweise sehr groß ist, verwenden Sie den Aufruf „paged“ und geben Sie in jedem Aufruf Bereiche der abzurufenden Threads an.

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

Parameter

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen, die dieser Anfrage entsprechen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Suchen Sie in Gmail mit der angegebenen Anfrage.

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

Parameter

Rückflug

GmailThread[] – ein Array von Gmail-Konversationen, die dieser Anfrage entsprechen

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Sendet eine E‑Mail-Nachricht. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 Nur-Text oder einen HTML-Textkörper enthalten. Die Größe der E‑Mail (einschließlich Kopfzeilen, aber ohne Anhänge) ist kontingentbeschränkt.

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

Parameter

Erweiterte Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• sendEmail(recipient, subject, body)

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

Diese Methode ist nur für Google Workspace-Add-on-Projekte erforderlich, die Gmail-Bereich für aktuelle Nachrichten verwenden.

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

Parameter

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Fügt dieser Nachricht einen Stern hinzu und erzwingt eine Aktualisierung der Nachricht.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• starMessages(messages)

Diesen Nachrichten werden Sterne hinzugefügt und sie werden aktualisiert.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• starMessage(message)

Entfernt die Sternmarkierung aus dieser Nachricht und erzwingt eine Aktualisierung der Nachricht.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• unstarMessages(messages)

Entfernt die Sternmarkierungen aus diesen Nachrichten und erzwingt eine Aktualisierung der Nachrichten.

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

Parameter

Rückflug

GmailApp: Der Gmail-Dienst, der sich gut für das Verketten eignet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• unstarMessage(message)