Class GmailDraft

GmailDraft

wersja robocza wiadomości utworzonej przez użytkownika na jego koncie Gmail.

Metody

MetodaZwracany typKrótki opis
deleteDraft()voidUsuwa tę wersję roboczą wiadomości.
getId()StringPobiera identyfikator tej wiadomości w wersji roboczej.
getMessage()GmailMessageZwraca GmailMessage reprezentujący tę wersję roboczą.
getMessageId()StringZwraca identyfikator GmailMessage reprezentujący ten projekt.
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 zawartość tego szkicu wiadomości za pomocą opcjonalnych argumentów.

Szczegółowa dokumentacja

deleteDraft()

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/

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 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/

getMessage()

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

GmailMessage – 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/

getMessageId()

Zwraca identyfikator GmailMessage 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

GmailMessage – 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

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

Powrót

GmailDraft – 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

NazwaTypOpis
recipientStringlista adresów e-mail rozdzielonych przecinkami
subjectStringtemat e-maila (maksymalnie 250 znaków).
bodyStringtreść e-maila
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablica plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielane przecinkami.
ccStringlistę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami.
fromStringadres, z którego ma zostać wysłany e-mail, który musi być jedną z wartości zwracanych przez GmailApp.getAliases()
htmlBodyStringjeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wstawione obrazy w e-mailu
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody i zawiera on odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie adres e-mail użytkownika);

Powrót

GmailDraft – 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ż