Предоставляет доступ к цепочкам, сообщениям и ярлыкам Gmail.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
createDraft(recipient, subject, body) | GmailDraft | Создает черновик сообщения электронной почты. |
createDraft(recipient, subject, body, options) | GmailDraft | Создает черновик сообщения электронной почты с необязательными аргументами. |
createLabel(name) | GmailLabel | Создайте новую метку пользователя с заданным именем. |
deleteLabel(label) | GmailApp | Удаляет указанную метку. |
getAliases() | String[] | Получает список адресов электронной почты, настроенных как псевдонимы для этой учетной записи в Gmail. |
getDraft(draftId) | GmailDraft | Получить черновик сообщения электронной почты по идентификатору. |
getDraftMessages() | GmailMessage[] | Извлекает все черновики сообщений. |
getDrafts() | GmailDraft[] | Получает все черновики сообщений Gmail. |
getInboxThreads() | GmailThread[] | Извлекает все потоки папки "Входящие" независимо от меток. |
getInboxThreads(start, max) | GmailThread[] | Извлекает диапазон цепочек входящих сообщений независимо от меток. |
getInboxUnreadCount() | Integer | Получает количество непрочитанных тем в папке «Входящие». |
getMessageById(id) | GmailMessage | Получает сообщение по ID. |
getMessagesForThread(thread) | GmailMessage[] | Получить все сообщения в указанном потоке. |
getMessagesForThreads(threads) | GmailMessage[][] | Получить все сообщения в указанных потоках. |
getPriorityInboxThreads() | GmailThread[] | Извлекает все потоки из папки «Приоритетные входящие» независимо от меток. |
getPriorityInboxThreads(start, max) | GmailThread[] | Извлекает диапазон цепочек из папки «Приоритетные входящие» независимо от меток. |
getPriorityInboxUnreadCount() | Integer | Получает количество непрочитанных цепочек в папке "Приоритетные". |
getSpamThreads() | GmailThread[] | Извлекает все потоки спама независимо от меток. |
getSpamThreads(start, max) | GmailThread[] | Извлекает диапазон потоков спама независимо от меток. |
getSpamUnreadCount() | Integer | Получает количество непрочитанных тем, которые являются спамом. |
getStarredThreads() | GmailThread[] | Извлекает все темы, помеченные звездочкой, независимо от меток. |
getStarredThreads(start, max) | GmailThread[] | Извлекает диапазон тем, помеченных звездочкой, независимо от меток. |
getStarredUnreadCount() | Integer | Получает количество непрочитанных потоков, отмеченных звездочкой. |
getThreadById(id) | GmailThread | Получает поток по идентификатору. |
getTrashThreads() | GmailThread[] | Извлекает все темы мусора независимо от меток. |
getTrashThreads(start, max) | GmailThread[] | Извлекает диапазон потоков мусора независимо от меток. |
getUserLabelByName(name) | GmailLabel | Извлекает метку по имени метки. |
getUserLabels() | GmailLabel[] | Получает список меток, созданных пользователем. |
markMessageRead(message) | GmailApp | Помечает это сообщение как прочитанное и принудительно обновляет сообщение. |
markMessageUnread(message) | GmailApp | Помечает это сообщение как непрочитанное и принудительно обновляет сообщение. |
markMessagesRead(messages) | GmailApp | Отмечает эти сообщения как прочитанные и принудительно обновляет сообщения. |
markMessagesUnread(messages) | GmailApp | Помечает эти сообщения как непрочитанные и принудительно обновляет сообщения. |
markThreadImportant(thread) | GmailApp | Отмечает этот поток как важный и принудительно обновляет поток. |
markThreadRead(thread) | GmailApp | Помечает этот поток как прочитанный и принудительно обновляет поток. |
markThreadUnimportant(thread) | GmailApp | Помечает этот поток как неважный и принудительно обновляет поток. |
markThreadUnread(thread) | GmailApp | Помечает этот поток как непрочитанный и принудительно обновляет поток. |
markThreadsImportant(threads) | GmailApp | Отмечает эти темы как важные и принудительно обновляет темы. |
markThreadsRead(threads) | GmailApp | Помечает эти потоки как прочитанные и принудительно обновляет потоки. |
markThreadsUnimportant(threads) | GmailApp | Помечает эти темы как неважные и принудительно обновляет темы. |
markThreadsUnread(threads) | GmailApp | Помечает эти темы как непрочитанные и принудительно обновляет темы. |
moveMessageToTrash(message) | GmailApp | Перемещает сообщение в корзину и принудительно обновляет сообщение. |
moveMessagesToTrash(messages) | GmailApp | Перемещает указанные сообщения в корзину и принудительно обновляет сообщения. |
moveThreadToArchive(thread) | GmailApp | Перемещает этот поток в архив и принудительно обновляет поток. |
moveThreadToInbox(thread) | GmailApp | Перемещает этот поток в папку "Входящие" и принудительно обновляет поток. |
moveThreadToSpam(thread) | GmailApp | Помещает этот поток в спам и принудительно обновляет поток. |
moveThreadToTrash(thread) | GmailApp | Перемещает этот поток в корзину и принудительно обновляет поток. |
moveThreadsToArchive(threads) | GmailApp | Перемещает эти потоки в архив и принудительно обновляет потоки. |
moveThreadsToInbox(threads) | GmailApp | Перемещает эти темы в папку "Входящие" и принудительно обновляет темы. |
moveThreadsToSpam(threads) | GmailApp | Перемещает эти темы в спам и принудительно обновляет темы. |
moveThreadsToTrash(threads) | GmailApp | Перемещает эти потоки в корзину и принудительно обновляет потоки. |
refreshMessage(message) | GmailApp | Перезагружает сообщение и связанное с ним состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились). |
refreshMessages(messages) | GmailApp | Перезагружает сообщения и связанное с ними состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились). |
refreshThread(thread) | GmailApp | Перезагружает поток и связанное с ним состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились). |
refreshThreads(threads) | GmailApp | Перезагружает потоки и связанное с ними состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились). |
search(query) | GmailThread[] | Найдите Gmail с заданным запросом. |
search(query, start, max) | GmailThread[] | Найдите Gmail с заданным запросом. |
sendEmail(recipient, subject, body) | GmailApp | Отправляет сообщение электронной почты. |
sendEmail(recipient, subject, body, options) | GmailApp | Отправляет сообщение электронной почты с необязательными аргументами. |
setCurrentMessageAccessToken(accessToken) | void | Задает токен доступа к текущему сообщению , который позволяет сценарию получать доступ к текущим свойствам GmailMessage . |
starMessage(message) | GmailApp | Добавляет звездочку к этому сообщению и принудительно обновляет сообщение. |
starMessages(messages) | GmailApp | Добавляет звездочки к этим сообщениям и принудительно обновляет сообщения. |
unstarMessage(message) | GmailApp | Удаляет звездочку из этого сообщения и принудительно обновляет сообщение. |
unstarMessages(messages) | GmailApp | Удаляет звездочки с этих сообщений и принудительно обновляет сообщения. |
Подробная документация
createDraft(recipient, subject, body)
Создает черновик сообщения электронной почты. Размер сообщения электронной почты (включая заголовки) ограничен квотой .
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
recipient | String | список адресов электронной почты, разделенных запятыми |
subject | String | тема письма |
body | String | тело письма |
Возвращаться
GmailDraft
— только что созданный GmailDraft
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
createDraft(recipient, subject, body, options)
Создает черновик сообщения электронной почты с необязательными аргументами. Электронное письмо может содержать обычный текст или тело HTML. Размер сообщения электронной почты (включая заголовки, но исключая вложения) ограничен квотой .
// 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' });
Параметры
Имя | Тип | Описание |
---|---|---|
recipient | String | адреса получателя |
subject | String | строка темы |
body | String | тело письма |
options | Object | объект JavaScript, который указывает расширенные параметры, как указано ниже |
Расширенные параметры
Имя | Тип | Описание |
---|---|---|
attachments | BlobSource[] | массив файлов для отправки по электронной почте |
bcc | String | разделенный запятыми список адресов электронной почты для BCC |
cc | String | разделенный запятыми список адресов электронной почты для CC |
from | String | адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых getAliases() |
htmlBody | String | если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты |
inlineImages | Object | объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" /> |
name | String | имя отправителя электронного письма (по умолчанию: имя пользователя) |
replyTo | String | адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя) |
Возвращаться
GmailDraft
— только что созданный GmailDraft
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
createLabel(name)
Создайте новую метку пользователя с заданным именем.
// Creates the label @FOO and logs label: FOO Logger.log("label: " + GmailApp.createLabel("FOO"));
Параметры
Имя | Тип | Описание |
---|---|---|
name | String | название нового лейбла |
Возвращаться
GmailLabel
— вновь созданный ярлык
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
deleteLabel(label)
Удаляет указанную метку.
// Have to get the label by name first var label = GmailApp.getUserLabelByName("FOO"); GmailApp.deleteLabel(label);
Параметры
Имя | Тип | Описание |
---|---|---|
label | GmailLabel | ярлык для удаления |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getAliases()
Получает список адресов электронной почты, настроенных как псевдонимы для этой учетной записи в Gmail.
Вы можете отправить сообщение с любого из этих псевдонимов, используя необязательный аргумент from.
// 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.'); }
Возвращаться
String[]
— массив псевдонимов для этого аккаунта
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getDraft(draftId)
Получить черновик сообщения электронной почты по идентификатору.
Используйте это в сочетании с getId() в черновиках Gmail.
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
draftId | String | ID черновика, который нужно получить |
Возвращаться
GmailDraft
— черновик с заданным идентификатором
Броски
Error
— если черновик с заданным ID не найден
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getDraftMessages()
Извлекает все черновики сообщений.
// Logs the number of draft messages var drafts = GmailApp.getDraftMessages(); Logger.log(drafts.length);
Возвращаться
GmailMessage[]
— массив черновиков сообщений Gmail.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getDrafts()
Получает все черновики сообщений Gmail.
var drafts = GmailApp.getDrafts(); for (var i = 0; i < drafts.length; i++) { Logger.log(drafts[i].getId()); }
Возвращаться
GmailDraft[]
— массив черновиков сообщений Gmail.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getInboxThreads()
Извлекает все потоки папки "Входящие" независимо от меток.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
// Log the subject lines of your Inbox var threads = GmailApp.getInboxThreads(); for (var i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Возвращаться
GmailThread[]
— массив веток Gmail в папке «Входящие».
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getInboxThreads(start, max)
Извлекает диапазон цепочек входящих сообщений независимо от меток.
// 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()); }
Параметры
Имя | Тип | Описание |
---|---|---|
start | Integer | индекс первого потока для получения |
max | Integer | максимальное количество потоков для извлечения |
Возвращаться
GmailThread[]
— массив веток Gmail в папке «Входящие».
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getInboxUnreadCount()
Получает количество непрочитанных тем в папке «Входящие».
Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());
Возвращаться
Integer
число — количество тредов в папке «Входящие», в которых есть непрочитанные сообщения.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getMessageById(id)
Получает сообщение по ID.
Используйте это в сочетании с getId() в сообщениях Gmail.
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
id | String | ID сообщения, которое нужно получить |
Возвращаться
GmailMessage
— сообщение с заданным идентификатором
Броски
Error
— если сообщение с заданным идентификатором не найдено
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getMessagesForThread(thread)
Получить все сообщения в указанном потоке.
// 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()); }
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | цепочка сообщений для извлечения |
Возвращаться
GmailMessage[]
— массив сообщений, соответствующих этой ветке
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getMessagesForThreads(threads)
Получить все сообщения в указанных потоках.
// 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()); } }
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | потоки сообщений для извлечения |
Возвращаться
GmailMessage[][]
— массив массивов сообщений, где каждый элемент внешнего массива соответствует потоку, а внутренний массив содержит сообщения в этом потоке.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getPriorityInboxThreads()
Извлекает все потоки из папки «Приоритетные входящие» независимо от меток.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
Logger.log("# of messages in your Priority Inbox: " + GmailApp.getPriorityInboxThreads().length);
Возвращаться
GmailThread[]
— массив цепочек сообщений Gmail в папке «Приоритетные».
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getPriorityInboxThreads(start, max)
Извлекает диапазон цепочек из папки «Приоритетные входящие» независимо от меток.
// Will log some number 2 or less Logger.log("# of messages in your Priority Inbox: " + GmailApp.getPriorityInboxThreads(0, 2).length);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Integer | индекс первого потока для получения |
max | Integer | максимальное количество потоков для извлечения |
Возвращаться
GmailThread[]
— массив цепочек сообщений Gmail в папке «Приоритетные».
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getPriorityInboxUnreadCount()
Получает количество непрочитанных цепочек в папке "Приоритетные".
Logger.log("Number of unread emails in your Priority Inbox : " + GmailApp.getPriorityInboxUnreadCount());
Возвращаться
Integer
число — количество цепочек в папке «Приоритетные», в которых есть непрочитанные сообщения.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getSpamThreads()
Извлекает все потоки спама независимо от меток.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);
Возвращаться
GmailThread[]
— массив тредов Gmail в папке со спамом
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getSpamThreads(start, max)
Извлекает диапазон потоков спама независимо от меток.
// Will log a number at most 5 Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Integer | индекс первого потока для получения |
max | Integer | максимальное количество потоков для извлечения |
Возвращаться
GmailThread[]
— массив тредов Gmail в папке со спамом
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getSpamUnreadCount()
Получает количество непрочитанных тем, которые являются спамом.
// 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/
getStarredThreads()
Извлекает все темы, помеченные звездочкой, независимо от меток.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
// Logs the number of starred threads Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);
Возвращаться
GmailThread[]
— массив помеченных тредов Gmail.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getStarredThreads(start, max)
Извлекает диапазон тем, помеченных звездочкой, независимо от меток.
// Logs the number of starred threads to a maximum of 5 Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Integer | индекс первого потока для получения |
max | Integer | максимальное количество потоков для извлечения |
Возвращаться
GmailThread[]
— массив помеченных тредов Gmail.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getStarredUnreadCount()
Получает количество непрочитанных потоков, отмеченных звездочкой.
Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());
Возвращаться
Integer
число — количество помеченных тредов с непрочитанными сообщениями.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getThreadById(id)
Получает поток по идентификатору.
Используйте это в сочетании с getId() в цепочках Gmail.
// Thread IDs can also be found in the location bar when you have a thread open in Gmail // get first inbox thread var firstThread = GmailApp.getInboxThreads(0,1)[0]; // Get the same thread by ID var threadById = GmailApp.getThreadById(firstThread.getId()); // Verify they are the same Logger.log(firstThread.getFirstMessageSubject() == threadById.getFirstMessageSubject());
Параметры
Имя | Тип | Описание |
---|---|---|
id | String | ID потока для получения |
Возвращаться
GmailThread
— поток с заданным идентификатором или null, если он не найден
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
getTrashThreads()
Извлекает все темы мусора независимо от меток.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);
Возвращаться
GmailThread[]
— массив тредов Gmail в корзине
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getTrashThreads(start, max)
Извлекает диапазон потоков мусора независимо от меток.
// Will log a number at most 5 Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);
Параметры
Имя | Тип | Описание |
---|---|---|
start | Integer | индекс первого потока для получения |
max | Integer | максимальное количество потоков для извлечения |
Возвращаться
GmailThread[]
— массив тредов Gmail в корзине
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getUserLabelByName(name)
Извлекает метку по имени метки.
var labelObject = GmailApp.getUserLabelByName("myLabel");
Параметры
Имя | Тип | Описание |
---|---|---|
name | String | имя ярлыка, который нужно получить |
Возвращаться
GmailLabel
— ярлык Gmail с заданным именем
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
getUserLabels()
Получает список меток, созданных пользователем.
// 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()); }
Возвращаться
GmailLabel[]
— массив ярлыков, созданных пользователем
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
markMessageRead(message)
Помечает это сообщение как прочитанное и принудительно обновляет сообщение.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение, которое нужно пометить как прочитанное |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markMessageUnread(message)
Помечает это сообщение как непрочитанное и принудительно обновляет сообщение.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение, которое нужно пометить как непрочитанное |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markMessagesRead(messages)
Отмечает эти сообщения как прочитанные и принудительно обновляет сообщения.
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | массив сообщений, которые нужно пометить как прочитанные |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markMessagesUnread(messages)
Помечает эти сообщения как непрочитанные и принудительно обновляет сообщения.
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | массив сообщений, которые нужно пометить как непрочитанные |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadImportant(thread)
Отмечает этот поток как важный и принудительно обновляет поток.
// Marks first inbox thread as important var thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadImportant(thread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему, которую нужно пометить как важную |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadRead(thread)
Помечает этот поток как прочитанный и принудительно обновляет поток.
// Marks first inbox thread as read var thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadRead(thread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему, которую нужно пометить как прочитанную |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadUnimportant(thread)
Помечает этот поток как неважный и принудительно обновляет поток.
// Marks first inbox thread as unimportant var thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadUnimportant(thread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему пометить как неважную |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadUnread(thread)
Помечает этот поток как непрочитанный и принудительно обновляет поток.
// Marks first inbox thread as unread var thread = GmailApp.getInboxThreads(0, 1)[0]; GmailApp.markThreadUnread(thread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему, которую нужно пометить как непрочитанную |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadsImportant(threads)
Отмечает эти темы как важные и принудительно обновляет темы.
// Marks first two threads in inbox as important var threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsImportant(threads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив тем для пометки как важные |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadsRead(threads)
Помечает эти потоки как прочитанные и принудительно обновляет потоки.
// Marks first two threads in inbox as read var threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsRead(threads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив потоков для пометки как прочитанных |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadsUnimportant(threads)
Помечает эти темы как неважные и принудительно обновляет темы.
// Marks first two threads in inbox as unimportant var threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsUnimportant(threads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив тем для пометки как неважных |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
markThreadsUnread(threads)
Помечает эти темы как непрочитанные и принудительно обновляет темы.
// Marks first two threads in inbox as unread var threads = GmailApp.getInboxThreads(0, 2); GmailApp.markThreadsUnread(threads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив тем для пометки как непрочитанных |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveMessageToTrash(message)
Перемещает сообщение в корзину и принудительно обновляет сообщение.
// Move the first message in your inbox to trash var firstThread = GmailApp.getInboxThreads(0,1)[0]; var firstMessage = firstThread.getMessages()[0]; GmailApp.moveMessageToTrash(firstMessage);
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение в корзину |
Возвращаться
GmailApp
— служба Gmail (полезно для цепочки)
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveMessagesToTrash(messages)
Перемещает указанные сообщения в корзину и принудительно обновляет сообщения.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | сообщения, которые нужно удалить |
Возвращаться
GmailApp
— служба Gmail (полезно для цепочки)
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadToArchive(thread)
Перемещает этот поток в архив и принудительно обновляет поток.
// Archive the first thread in your inbox var firstThread = GmailApp.getInboxThreads(0,1)[0]; GmailApp.moveThreadToArchive(firstThread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тема для архива |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadToInbox(thread)
Перемещает этот поток в папку "Входящие" и принудительно обновляет поток.
// Find a thread not already in your inbox var thread = GmailApp.search("-in:inbox")[0]; // Get the first one GmailApp.moveThreadToInbox(thread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему переместить в папку "Входящие" |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadToSpam(thread)
Помещает этот поток в спам и принудительно обновляет поток.
// Tag first thread in inbox as spam var firstThread = GmailApp.getInboxThreads(0,1)[0]; GmailApp.moveThreadToSpam(firstThread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | тему переместить в спам |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadToTrash(thread)
Перемещает этот поток в корзину и принудительно обновляет поток.
// Move first thread in inbox to trash var firstThread = GmailApp.getInboxThreads(0,1)[0]; GmailApp.moveThreadToTrash(firstThread);
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | ветка на помойку |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadsToArchive(threads)
Перемещает эти потоки в архив и принудительно обновляет потоки.
// Move first two threads in your inbox to the archive var firstTwoThreads = GmailApp.getInboxThreads(0,2); GmailApp.moveThreadsToArchive(firstTwoThreads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив потоков для архивирования |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadsToInbox(threads)
Перемещает эти темы в папку "Входящие" и принудительно обновляет темы.
// Find two threads not already in your inbox var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2); GmailApp.moveThreadsToInbox(firstTwoThreads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив тем для перемещения в папку "Входящие" |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadsToSpam(threads)
Перемещает эти темы в спам и принудительно обновляет темы.
// Move first two threads in your inbox to spam var firstTwoThreads = GmailApp.getInboxThreads(0,2); GmailApp.moveThreadsToSpam(firstTwoThreads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив тем для перемещения в спам |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
moveThreadsToTrash(threads)
Перемещает эти потоки в корзину и принудительно обновляет потоки.
// Move first two threads in your inbox to trash var firstTwoThreads = GmailApp.getInboxThreads(0,2); GmailApp.moveThreadsToTrash(firstTwoThreads);
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | массив потоков, которые нужно удалить |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
refreshMessage(message)
Перезагружает сообщение и связанное с ним состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились).
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...
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение, которое нужно обновить |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
refreshMessages(messages)
Перезагружает сообщения и связанное с ними состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились).
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...
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | сообщения, которые нужно обновить |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
refreshThread(thread)
Перезагружает поток и связанное с ним состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились).
var firstThread = GmailApp.getInboxThreads(0,1)[0]; // ...Do something that may take a while here.... GmailApp.refreshThread(firstThread); // ... Do more stuff with the thread ...
Параметры
Имя | Тип | Описание |
---|---|---|
thread | GmailThread | ветка для обновления |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
refreshThreads(threads)
Перезагружает потоки и связанное с ними состояние из Gmail (полезно, если метки, состояние чтения и т. д. изменились).
var threads = GmailApp.getInboxThreads(0, 3); // ...Do something that may take a while here.... GmailApp.refreshThreads(threads); // ... Do more stuff with threads ...
Параметры
Имя | Тип | Описание |
---|---|---|
threads | GmailThread[] | темы для обновления |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
search(query)
Найдите Gmail с заданным запросом.
Этот вызов завершится ошибкой, если размер всех потоков слишком велик для обработки системой. Если размер потока неизвестен и потенциально может быть очень большим, используйте вызов 'paged' и укажите диапазоны потоков для извлечения в каждом вызове.
// Find starred messages with subject IMPORTANT var threads = GmailApp.search('is:starred subject:"IMPORTANT"');
Параметры
Имя | Тип | Описание |
---|---|---|
query | String | поисковый запрос, как если бы вы вводили его в Gmail |
Возвращаться
GmailThread[]
— массив тредов Gmail, соответствующих этому запросу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
search(query, start, max)
Найдите 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. var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);
Параметры
Имя | Тип | Описание |
---|---|---|
query | String | поисковый запрос, как если бы вы вводили его в Gmail |
start | Integer | индекс начального потока |
max | Integer | максимальное количество потоков для возврата |
Возвращаться
GmailThread[]
— массив тредов Gmail, соответствующих этому запросу.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
sendEmail(recipient, subject, body)
Отправляет сообщение электронной почты. Размер сообщения электронной почты (включая заголовки) ограничен квотой .
// 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());
Параметры
Имя | Тип | Описание |
---|---|---|
recipient | String | список адресов электронной почты, разделенных запятыми |
subject | String | тема письма (максимум 250 символов) |
body | String | тело письма |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
sendEmail(recipient, subject, body, options)
Отправляет сообщение электронной почты с необязательными аргументами. Электронное письмо может содержать обычный текст или тело HTML. Размер сообщения электронной почты (включая заголовки, но исключая вложения) ограничен квотой .
// 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' });
Параметры
Имя | Тип | Описание |
---|---|---|
recipient | String | адреса получателя |
subject | String | строка темы (максимум 250 символов) |
body | String | тело письма |
options | Object | объект JavaScript, который указывает расширенные параметры, как указано ниже |
Расширенные параметры
Имя | Тип | Описание |
---|---|---|
attachments | BlobSource[] | массив файлов для отправки по электронной почте |
bcc | String | разделенный запятыми список адресов электронной почты для BCC |
cc | String | разделенный запятыми список адресов электронной почты для CC |
from | String | адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых getAliases() |
htmlBody | String | если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты |
inlineImages | Object | объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" /> |
name | String | имя отправителя электронного письма (по умолчанию: имя пользователя) |
noReply | Boolean | true , если электронное письмо должно быть отправлено с общего адреса электронной почты, на который не отвечают, чтобы получатели не отвечали на электронные письма; этот вариант возможен только для учетных записей Google Workspace, но не для пользователей Gmail. |
replyTo | String | адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя) |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
setCurrentMessageAccessToken(accessToken)
Задает токен доступа к текущему сообщению , который позволяет сценарию получать доступ к текущим свойствам GmailMessage
.
Этот метод требуется только для проектов надстройки Google Workspace , использующих области текущих сообщений Gmail.
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 }
Параметры
Имя | Тип | Описание |
---|---|---|
accessToken | String | токен временного доступа, полученный из объекта события действия надстройки Gmail . |
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
starMessage(message)
Добавляет звездочку к этому сообщению и принудительно обновляет сообщение.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение для пометки |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
starMessages(messages)
Добавляет звездочки к этим сообщениям и принудительно обновляет сообщения.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | массив сообщений для пометки |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
unstarMessage(message)
Удаляет звездочку из этого сообщения и принудительно обновляет сообщение.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
message | GmailMessage | сообщение снять пометку |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/
Смотрите также
unstarMessages(messages)
Удаляет звездочки с этих сообщений и принудительно обновляет сообщения.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
messages | GmailMessage[] | массив сообщений, которые нужно удалить |
Возвращаться
GmailApp
— служба Gmail, полезная для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :
-
https://mail.google.com/