Поля сообщения

Типичное сообщение электронной почты содержит в себе несколько полей. Поля могут быть установлены через передачу аргументов конструктору класса EmailMessage, методу initialize() или с помощью задания атрибутов экземпляра класса EmailMessage. Также сообщение может быть отправлено через вызов функции send_mail() с передачей его параметров в качестве аргументов.

Адрес получателя может быть задан как обычный адрес электронной почты (Albert.Johnson@example.com) или в виде имени отправителя и его адреса: Albert Johnson <Albert.Johnson@example.com>. Адрес отправителя в свою очередь может быть задан только с помощью одного адреса.

Ниже описываются возможные поля сообщения:

sender

Адрес электронной почты отправителя, указываемый в поле From заголовка сообщения. Он может быть только адресом электронной почты зарегистрированного администратора приложения или адресом текущего авторизованного пользователя. Администраторы указываются с использованием Административной консоли. Адрес текущего авторизованного пользователя может быть определен с помощью Users API.

to

Адрес получателя сообщения или их список, которые будут представлены в поле To: заголовка сообщения.

cc

Адрес получателя сообщения или их список, которые будут представлены в поле Cc: заголовка сообщения.

bcc

Адрес получателя или их список, которым будет отправлена копия сообщения, но они не будут указаны в его заголовке ("слепая копия").

reply_to

Адрес электронной почты, на который получатель сможет отправить ответ, вместо заданного в параметре sender, является значением поля Reply-To:.

subject

Тема сообщения, указываемая в его заголовке Subject:.

body

Текстовый вид содержания сообщения.

html

HTML версия содержания сообщения, отображается при заданных настройках клиента электронной почты его получателя.

attachments

Файловые вложения, представленные в виде списка кортежей, каждый из которых описывает отдельный файл. Кортеж должен содержать два элемента: имя файла и его содержимое.

В сообщениях электронной почты можно использовать только ограниченный список типов файлов, определяемый системой по их расширениям. Для дополнительной информации о допустимых типах смотрите раздел Допустимые типы вложений.