Class GmailDraft

GmailDraft

Wersja robocza wiadomości utworzona przez użytkownika na koncie Gmail użytkownika.

Metody

MetodaZwracany typKrótki opis
deleteDraft()voidUsuwa tę wersję roboczą wiadomości.
getId()StringPobiera identyfikator tej wersji roboczej wiadomości.
getMessage()GmailMessageZwraca wiadomość GmailMessage reprezentującą tę wersję roboczą.
getMessageId()StringZwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą.
send()GmailMessageWysyła wersję roboczą e-maila.
update(recipient, subject, body)GmailDraftZastępuje treść tej wersji roboczej wiadomości.
update(recipient, subject, body, options)GmailDraftZastępuje treść tej wersji roboczej wiadomości przy użyciu opcjonalnych argumentów.

Szczegółowa dokumentacja

deleteDraft()

Usuwa tę wersję roboczą wiadomości.

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

getId()

Pobiera identyfikator tej wersji roboczej wiadomości.

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

Powroty

String – identyfikator wersji roboczej,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

getMessage()

Zwraca wiadomość GmailMessage reprezentującą tę wersję roboczą.

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

Powroty

GmailMessage – wiadomość, która przedstawia zawartość wersji roboczej;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

getMessageId()

Zwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą.

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

Powroty

String – identyfikator wiadomości,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

send()

Wysyła wersję roboczą e-maila. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

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

Powroty

GmailMessage – nowo wysłana wiadomość,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

update(recipient, subject, body)

Zastępuje treść tej wersji roboczej wiadomości. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

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

Parametry

NazwaTypOpis
recipientStringlista adresów e-mail oddzielonych przecinkami
subjectStringtemat e-maila (maksymalnie 250 znaków)
bodyStringtreść e-maila.

Powroty

GmailDraft – niedawno zaktualizowana wersja robocza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

Zobacz też


update(recipient, subject, body, options)

Zastępuje treść tej wersji roboczej wiadomości przy użyciu opcjonalnych argumentów. Może zawierać zwykły tekst lub treść HTML. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

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

Parametry

NazwaTypOpis
recipientStringlista adresów e-mail oddzielonych przecinkami
subjectStringtemat e-maila (maksymalnie 250 znaków)
bodyStringtreść e-maila.
optionsObjectobiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringJeśli zasada jest skonfigurowana, urządzenia mogące renderować kod HTML będą używać go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz w e-mailu obrazy w treści.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)

Powroty

GmailDraft – niedawno zaktualizowana wersja robocza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • https://mail.google.com/

Zobacz też