Class GmailApp

Создает черновик сообщения электронной почты. Размер электронного письма (включая заголовки) ограничен квотой .

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

Параметры

Возвращаться

Gmail Draft — недавно созданный GmailDraft.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• create Draft(recipient, subject, body, options)

Создает черновик сообщения электронной почты с необязательными аргументами. Электронное письмо может содержать обычный текст или тело HTML. Размер электронного письма (включая заголовки, но исключая вложения) ограничен квотой .

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

Параметры

Расширенные параметры

Возвращаться

Gmail Draft — недавно созданный GmailDraft.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• create Draft(recipient, subject, body)

Создайте новую метку пользователя с данным именем.

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

Параметры

Возвращаться

Gmail Label — недавно созданный ярлык.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• delete Label(label)

Удаляет указанную метку.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• create Label(name)

Получает список адресов электронной почты, настроенных в качестве псевдонимов для этой учетной записи в Gmail.

Вы можете отправить сообщение с любого из этих псевдонимов, используя необязательный аргумент «от».

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

Возвращаться

String[] — массив псевдонимов для этого аккаунта

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• send Email(recipient, subject, body, options)

Получить черновик сообщения электронной почты по идентификатору.

Используйте это вместе с getId() в черновиках 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(),
);

Параметры

Возвращаться

Gmail Draft — черновик с заданным идентификатором

Броски

Error — если не найден черновик с данным идентификатором.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает все черновики сообщений.

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

Возвращаться

Gmail Message[] — массив черновиков сообщений Gmail.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает все черновики сообщений Gmail.

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

Возвращаться

Gmail Draft[] — массив черновиков сообщений Gmail.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает все ветки папки «Входящие» независимо от меток.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Возвращаться

Gmail Thread[] — массив цепочек Gmail в папке «Входящие».

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает диапазон веток папки «Входящие» независимо от меток.

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

Параметры

Возвращаться

Gmail Thread[] — массив цепочек Gmail в папке «Входящие».

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает количество непрочитанных цепочек в папке «Входящие».

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

Возвращаться

Integer — количество тредов во входящих, в которых есть непрочитанные сообщения.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает сообщение по идентификатору.

Используйте это вместе с getId() в сообщениях 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());

Параметры

Возвращаться

Gmail Message — сообщение с заданным идентификатором.

Броски

Error — если сообщение с данным идентификатором не найдено.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• get Thread By Id(id)

Получить все сообщения в указанном потоке.

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

Параметры

Возвращаться

Gmail Message[] — массив сообщений, соответствующих этой теме.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• get Messages For Threads(threads)

Получить все сообщения в указанных потоках.

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

Параметры

Возвращаться

Gmail Message[][] — массив массивов сообщений, где каждый элемент внешнего массива соответствует потоку, а внутренний массив содержит сообщения в этом потоке.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• get Messages For Thread(thread)

Извлекает все цепочки приоритетных входящих независимо от меток.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Возвращаться

Gmail Thread[] — массив цепочек Gmail в папке «Приоритетные входящие».

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает ряд цепочек приоритетных входящих независимо от меток.

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

Параметры

Возвращаться

Gmail Thread[] — массив цепочек Gmail в папке «Приоритетные входящие».

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает количество непрочитанных цепочек в папке «Приоритетные входящие».

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

Возвращаться

Integer — количество цепочек в папке «Приоритетные входящие», в которых есть непрочитанные сообщения.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает все спам-темы независимо от меток.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Возвращаться

Gmail Thread[] — массив тредов Gmail в папке со спамом.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает ряд спам-сообщений независимо от меток.

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

Параметры

Возвращаться

Gmail Thread[] — массив тредов Gmail в папке со спамом.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает количество непрочитанных тем, являющихся спамом.

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

Возвращаться

Integer — количество спам-тем, в которых есть непрочитанные сообщения.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает все помеченные темы независимо от меток.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Возвращаться

Gmail Thread[] — массив помеченных тем Gmail.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает диапазон отмеченных тем независимо от меток.

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

Параметры

Возвращаться

Gmail Thread[] — массив помеченных тем Gmail.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает количество помеченных непрочитанных тем.

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

Возвращаться

Integer — количество отмеченных тем с непрочитанными сообщениями.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает поток по идентификатору.

Используйте это вместе с getId() в цепочках 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(),
);

Параметры

Возвращаться

Gmail Thread — ветка с заданным идентификатором или null , если она не найдена.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• get Message By Id(id)

Извлекает все мусорные темы независимо от меток.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Возвращаться

Gmail Thread[] — массив тредов Gmail в корзине.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Извлекает ряд мусорных потоков независимо от меток.

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

Параметры

Возвращаться

Gmail Thread[] — массив тредов Gmail в корзине.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает метку по ее имени.

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

Параметры

Возвращаться

Gmail Label — ярлык Gmail с заданным именем.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Получает список меток, созданных пользователем.

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

Возвращаться

Gmail Label[] — массив созданных пользователем ярлыков.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Отмечает это сообщение как прочитанное и принудительно обновляет его.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Message Unread(message)

Помечает это сообщение как непрочитанное и принудительно обновляет сообщение.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Message Read(message)

Помечает эти сообщения как прочитанные и принудительно обновляет сообщения.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Messages Unread(messages)

Помечает эти сообщения как непрочитанные и принудительно обновляет сообщения.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Messages Read(messages)

Отмечает эту тему как важную и принудительно обновляет ее.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Thread Unimportant(thread)

Помечает эту тему как прочитанную и принудительно обновляет ее.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Thread Unread(thread)

Помечает этот поток как неважный и принудительно обновляет поток.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Thread Important(thread)

Помечает эту тему как непрочитанную и принудительно обновляет ее.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Thread Read(thread)

Помечает эти темы как важные и принудительно обновляет их.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Threads Unimportant(threads)

Помечает эти потоки как прочитанные и принудительно обновляет потоки.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Threads Unread(threads)

Помечает эти потоки как неважные и принудительно обновляет их.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Threads Important(threads)

Помечает эти темы как непрочитанные и принудительно обновляет их.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• mark Threads Read(threads)

Перемещает сообщение в корзину и принудительно обновляет сообщение.

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

Параметры

Возвращаться

Gmail App — служба Gmail (полезна для создания цепочки)

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Messages To Trash(messages)

Перемещает указанные сообщения в корзину и принудительно обновляет сообщения.

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

Параметры

Возвращаться

Gmail App — служба Gmail (полезна для создания цепочки)

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Message To Trash(message)

Перемещает этот поток в архив и принудительно обновляет поток.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Thread To Inbox(thread)
• move Thread To Spam(thread)
• move Thread To Trash(thread)

Перемещает эту цепочку в папку «Входящие» и принудительно ее обновляет.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Thread To Trash(thread)
• move Thread To Spam(thread)
• move Thread To Archive(thread)

Перемещает эту тему в спам и принудительно обновляет ее.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Thread To Trash(thread)
• move Thread To Inbox(thread)
• move Thread To Archive(thread)

Перемещает эту тему в корзину и принудительно обновляет ее.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Thread To Inbox(thread)
• move Thread To Spam(thread)
• move Thread To Archive(thread)

Перемещает эти потоки в архив и принудительно обновляет потоки.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Threads To Inbox(threads)
• move Threads To Spam(threads)
• move Threads To Trash(threads)

Перемещает эти темы во входящие и принудительно обновляет их.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Threads To Trash(threads)
• move Threads To Spam(threads)
• move Threads To Archive(threads)

Перемещает эти темы в спам и принудительно обновляет их.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Threads To Inbox(threads)
• move Threads To Trash(threads)
• move Threads To Archive(threads)

Перемещает эти потоки в корзину и принудительно обновляет потоки.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• move Threads To Inbox(threads)
• move Threads To Spam(threads)
• move Threads To Archive(threads)

Перезагружает сообщение и связанное с ним состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.).

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• refresh Messages(messages)

Перезагружает сообщения и связанное с ними состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.).

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• refresh Message(message)

Перезагружает цепочку и связанное с ней состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.).

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• refresh Threads(threads)

Перезагружает потоки и связанное с ними состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.).

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• refresh Thread(thread)

Найдите Gmail по заданному запросу.

Этот вызов завершится неудачно, если размер всех потоков слишком велик для системы. Если размер потока неизвестен и потенциально очень велик, используйте вызов «paged» и укажите диапазоны потоков, которые будут извлекаться при каждом вызове.

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

Параметры

Возвращаться

Gmail Thread[] — массив тредов Gmail, соответствующих этому запросу.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Найдите Gmail по заданному запросу.

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

Параметры

Возвращаться

Gmail Thread[] — массив тредов Gmail, соответствующих этому запросу.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Отправляет сообщение электронной почты. Размер электронного письма (включая заголовки) ограничен квотой .

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочек сообщений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• send Email(recipient, subject, body, options)

Отправляет сообщение электронной почты с необязательными аргументами. Электронное письмо может содержать обычный текст или тело HTML. Размер электронного письма (включая заголовки, но исключая вложения) ограничен квотой .

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

Параметры

Расширенные параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочек сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• send Email(recipient, subject, body)

Устанавливает токен доступа к текущему сообщению , который позволяет сценарию получать доступ к текущим свойствам Gmail Message .

Этот метод требуется только для проектов надстроек Google Workspace, использующих области текущих сообщений Gmail.

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

Параметры

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

Добавляет звездочку к этому сообщению и принудительно обновляет сообщение.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• star Messages(messages)

Добавляет звездочки к этим сообщениям и принудительно обновляет сообщения.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Скрипты, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• star Message(message)

Удаляет звездочку из этого сообщения и принудительно обновляет сообщение.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочек сообщений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• unstar Messages(messages)

Удаляет звездочки из этих сообщений и принудительно обновляет сообщения.

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

Параметры

Возвращаться

Gmail App — служба Gmail, полезная для создания цепочки сообщений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего REST API :

• https://mail.google.com/

См. также

• unstar Message(message)