wersja robocza wiadomości utworzonej przez użytkownika na jego koncie Gmail.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
delete | void | Usuwa tę wersję roboczą wiadomości. |
get | String | Pobiera identyfikator tej wiadomości w wersji roboczej. |
get | Gmail | Zwraca GmailMessage reprezentujący tę wersję roboczą. |
get | String | Zwraca identyfikator Gmail reprezentujący ten projekt. |
send() | Gmail | Wysyła wersję roboczą e-maila. |
update(recipient, subject, body) | Gmail | Zastępuje treść tej wersji roboczej wiadomości. |
update(recipient, subject, body, options) | Gmail | Zastępuje zawartość tego szkicu wiadomości za pomocą opcjonalnych argumentów. |
Szczegółowa dokumentacja
delete Draft()
Usuwa tę wersję roboczą wiadomości.
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder draft.deleteDraft(); draft.getMessage(); // Throws exception.
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
get Id()
Pobiera identyfikator tej wiadomości w wersji roboczej.
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(), );
Powrót
String
– identyfikator projektu
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
get Message()
Zwraca GmailMessage reprezentujący tę wersję roboczą.
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const message = draft.getMessage(); Logger.log(message.getSubject());
Powrót
Gmail
– wiadomość, która reprezentuje zawartość tego projektu.
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
get Message Id()
Zwraca identyfikator Gmail
reprezentujący ten projekt.
const draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder const messageId = draft.getMessageId(); Logger.log(messageId === draft.getMessage().getId());
Powrót
String
– identyfikator wiadomości
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
send()
Wysyła wersję roboczą e-maila. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit konty.
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
Powrót
Gmail
– nowo wysłana wiadomość
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
update(recipient, subject, body)
Zastępuje treść tej wersji roboczej wiadomości. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit konty.
// 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()}`, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
recipient | String | lista adresów e-mail rozdzielonych przecinkami |
subject | String | temat e-maila (maksymalnie 250 znaków). |
body | String | treść e-maila |
Powrót
Gmail
– nowo zaktualizowana wersja robocza.
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
update(recipient, subject, body, options)
Zastępuje zawartość tego szkicu wiadomości za pomocą opcjonalnych argumentów. E-mail może zawierać zwykły tekst lub treść w formacie HTML. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit konty.
// 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', }, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
recipient | String | lista adresów e-mail rozdzielonych przecinkami |
subject | String | temat e-maila (maksymalnie 250 znaków). |
body | String | treść e-maila |
options | Object | obiekt JavaScript określający parametry zaawansowane, wymienione poniżej; |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | Blob | tablica plików do wysłania z e-mailem. |
bcc | String | lista adresów e-mail do pola UDW rozdzielane przecinkami. |
cc | String | listę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami. |
from | String | adres, z którego ma zostać wysłany e-mail, który musi być jedną z wartości zwracanych przez Gmail |
html | String | jeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole inline w treści HTML, jeśli masz wstawione obrazy w e-mailu |
inline | Object | obiekt JavaScript zawierający mapowanie klucza obrazu (String ) na dane obrazu (Blob ); zakłada się, że używany jest parametr html i zawiera on odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika); |
reply | String | adres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie adres e-mail użytkownika); |
Powrót
Gmail
– nowo zaktualizowana wersja robocza.
Autoryzacja
Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:
-
https://mail.google.com/