Wersja robocza wiadomości utworzona przez użytkownika na koncie Gmail użytkownika.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
deleteDraft() | void | Usuwa tę wersję roboczą wiadomości. |
getId() | String | Pobiera identyfikator tej wersji roboczej wiadomości. |
getMessage() | GmailMessage | Zwraca wiadomość GmailMessage reprezentującą tę wersję roboczą. |
getMessageId() | String | Zwraca identyfikator elementu GmailMessage reprezentującego tę wersję roboczą. |
send() | GmailMessage | Wysyła wersję roboczą e-maila. |
update(recipient, subject, body) | GmailDraft | Zastępuje treść tej wersji roboczej wiadomości. |
update(recipient, subject, body, options) | GmailDraft | Zastę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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | lista adresów e-mail oddzielonych przecinkami |
subject | String | temat e-maila (maksymalnie 250 znaków) |
body | String | treść 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
Nazwa | Typ | Opis |
---|---|---|
recipient | String | lista adresów e-mail oddzielonych przecinkami |
subject | String | temat e-maila (maksymalnie 250 znaków) |
body | String | treść e-maila. |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablicę plików do wysłania w e-mailu. |
bcc | String | rozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW |
cc | String | oddziel adresy e-mail przecinkami |
from | String | Adres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases() . |
htmlBody | String | Jeś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. |
inlineImages | Object | obiekt 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" /> |
name | String | nazwa nadawcy e-maila (domyślnie: nazwa użytkownika), |
replyTo | String | adres 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/