Class GmailDraft

GmailDraft

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

Metody

Metoda	Zwracany typ	Krótki opis
deleteDraft()	void	Usuwa tę wiadomość w wersji roboczej.
getId()	String	Pobiera identyfikator tej wiadomości w wersji roboczej.
getMessage()	GmailMessage	Zwraca obiekt GmailMessage reprezentujący tę wersję roboczą.
getMessageId()	String	Zwraca identyfikator GmailMessage reprezentujący tę wersję roboczą.
send()	GmailMessage	Wysyła ten e-mail w wersji roboczej.
update(recipient, subject, body)	GmailDraft	Zastępuje treść tej wersji roboczej wiadomości.
update(recipient, subject, body, options)	GmailDraft	Zastępuje zawartość tej wersji roboczej wiadomości za pomocą argumentów opcjonalnych.

Szczegółowa dokumentacja

deleteDraft()

Usuwa tę wiadomość w wersji roboczej.

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

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

---

getId()

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 wersji roboczej;

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

---

getMessage()

Zwraca obiekt 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

GmailMessage – wiadomość reprezentująca zawartość tego szkicu.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

---

getMessageId()

Zwraca identyfikator GmailMessage reprezentujący tę wersję roboczą.

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

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

---

send()

Wysyła ten e-mail w wersji roboczej. Rozmiar e-maila (wraz z nagłówkami) przekracza limit.

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

GmailMessage – nowo wysłana wiadomość.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 (wraz z nagłówkami) przekracza limit.

// 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(
    '[e-mail]',
    '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

GmailDraft – nowa zaktualizowana wersja robocza

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

Zobacz też

• GmailApp.createDraft(recipient, subject, body)

---

update(recipient, subject, body, options)

Zastępuje zawartość tej wersji roboczej wiadomości za pomocą argumentów opcjonalnych. E-mail może zawierać zwykły tekst lub treść w formacie HTML. Rozmiar e-maila (wraz z nagłówkami) przekracza limit.

// 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(
    '[e-mail]',
    '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 JavaScriptu, który określa parametry zaawansowane wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablicę plików do wysłania z e-mailem.
bcc	String	lista adresów e-mail do pola UDW rozdzielona przecinkami;
cc	String	lista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
from	String	adres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBody	String	jeśli jest ustawiony, urządzenia obsługujące HTML będą go używać zamiast wymaganego argumentu body; w treści HTML możesz dodać opcjonalne pole inlineImages, jeśli masz wstawione obrazy w e-mailu
inlineImages	Object	obiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który 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ć używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);

Powrót

GmailDraft – nowa zaktualizowana wersja robocza

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

• https://mail.google.com/

Zobacz też

• GmailApp.createDraft(recipient, subject, body, options)