Class GmailDraft

Черновик Gmail

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

Методы

Метод Тип возврата Краткое описание
delete Draft() void Удаляет этот черновик сообщения.
get Id() String Получает идентификатор этого черновика сообщения.
get Message() Gmail Message Возвращает сообщение GmailMessage, представляющее этот черновик.
get Message Id() String Возвращает идентификатор Gmail Message представляющего этот черновик.
send() Gmail Message Отправляет этот черновик сообщения электронной почты.
update(recipient, subject, body) Gmail Draft Заменяет содержимое этого черновика сообщения.
update(recipient, subject, body, options) Gmail Draft Заменяет содержимое этого черновика сообщения, используя необязательные аргументы.

Подробная документация

delete Draft()

Удаляет этот черновик сообщения.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage();  // Throws exception.

Авторизация

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

  • https://mail.google.com/

get Id()

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

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const draftById = GmailApp.getDraft(draftId);
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

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

String — идентификатор черновика

Авторизация

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

  • https://mail.google.com/

get Message()

Возвращает сообщение GmailMessage, представляющее этот черновик.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const message = draft.getMessage();
Logger.log(message.getSubject());

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

Gmail Message — сообщение, представляющее содержимое этого черновика.

Авторизация

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

  • https://mail.google.com/

get Message Id()

Возвращает идентификатор Gmail Message представляющего этот черновик.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const messageId = draft.getMessageId();
Logger.log(messageId === draft.getMessage().getId());

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

String — идентификатор сообщения

Авторизация

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

  • https://mail.google.com/

send()

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

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const msg = draft.send();     // Send it
Logger.log(msg.getDate());    // Should be approximately the current timestamp

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

Gmail Message — только что отправленное сообщение.

Авторизация

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

  • https://mail.google.com/

update(recipient, subject, body)

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

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const now = new Date();
draft.update(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

Параметры

Имя Тип Описание
recipient String список адресов электронной почты, разделенный запятыми
subject String тема письма (максимум 250 символов)
body String тело электронного письма

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

Gmail Draft — недавно обновленный проект

Авторизация

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

  • https://mail.google.com/

См. также

update(recipient, subject, body, options)

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

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update(
    'mike@example.com',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

Параметры

Имя Тип Описание
recipient String список адресов электронной почты, разделенный запятыми
subject String тема письма (максимум 250 символов)
body String тело электронного письма
options Object объект JavaScript, который определяет дополнительные параметры, как указано ниже

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

Имя Тип Описание
attachments Blob Source[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых Gmail App.getAliases()
html Body String если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента тела; вы можете добавить дополнительное inline Images в тело HTML, если у вас есть встроенные изображения для вашего электронного письма.
inline Images Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( Blob Source ); при этом предполагается, что используется параметр html Body и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
reply To String адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)

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

Gmail Draft — недавно обновленный черновик

Авторизация

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

  • https://mail.google.com/

См. также