Class GmailMessage

GmailMessage

Wiadomość na koncie Gmail użytkownika.

Metody

MetodaZwracany typKrótki opis
createDraftReply(body)GmailDraftTworzy wersję roboczą wiadomości z adresem zwrotnym, odpowiadając nadawcy tej wiadomości.
createDraftReply(body, options)GmailDraftTworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego argumentów opcjonalnych.
createDraftReplyAll(body)GmailDraftTworzy wersję roboczą wiadomości z adresem zwrotnym i wszystkimi adresatami wiadomości, które są wysyłane do nadawcy tę wiadomość.
createDraftReplyAll(body, options)GmailDraftTworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami.
forward(recipient)GmailMessagePowoduje przekazanie tej wiadomości do nowych odbiorców.
forward(recipient, options)GmailMessagePowoduje przekazanie tej wiadomości do nowych odbiorców z opcjonalnymi argumentami.
getAttachments()GmailAttachment[]Pobiera wszystkie załączniki do tej wiadomości.
getAttachments(options)GmailAttachment[]Pobiera wszystkie załączniki do tej wiadomości.
getBcc()StringPobiera rozdzielane przecinkami adresatów w polu UDW tej wiadomości.
getBody()StringPobiera treść HTML treści wiadomości.
getCc()StringPobiera rozdzielane przecinkami adresy odbiorców, których kopia została umieszczona w polu DW tej wiadomości.
getDate()DatePobiera datę i godzinę wysłania tej wiadomości.
getFrom()StringPobiera nadawcę wiadomości.
getHeader(name)StringPobiera wartość nagłówka RFC 2822 na podstawie nazwy nagłówka.
getId()StringPobiera identyfikator wiadomości.
getPlainBody()StringPobiera treść wiadomości bez formatowania HTML.
getRawContent()StringPobiera nieprzetworzoną treść wiadomości.
getReplyTo()StringPobiera adres zwrotny dla tej wiadomości (zwykle jest to adres nadawcy).
getSubject()StringPobiera temat wiadomości.
getThread()GmailThreadPobiera wątek zawierający tę wiadomość.
getTo()StringPobiera rozdzielanych przecinkami adresatów tej wiadomości.
isDraft()BooleanOkreśla, czy wiadomość jest wersją roboczą.
isInChats()BooleanOkreśla, czy wiadomość to czat.
isInInbox()BooleanOkreśla, czy wiadomość znajduje się w skrzynce odbiorczej.
isInPriorityInbox()BooleanZwraca true, jeśli wiadomość jest w Priorytetach. w przeciwnym razie zwraca false.
isInTrash()BooleanOkreśla, czy wiadomość znajduje się w koszu.
isStarred()BooleanOkreśla, czy wiadomość została oznaczona gwiazdką.
isUnread()BooleanSprawdza, czy wiadomość jest nieprzeczytana.
markRead()GmailMessageOznacza wiadomość jako przeczytaną.
markUnread()GmailMessageOznacza wiadomość jako nieprzeczytaną.
moveToTrash()GmailMessagePrzenosi wiadomość do kosza.
refresh()GmailMessagePonownie wczytuje tę wiadomość i powiązany z nią stan z Gmaila (przydatne, gdy etykiety, stan odczytu itp., uległy zmianie).
reply(body)GmailMessageOdpowiada nadawcy tej wiadomości, używając adresu zwrotnego.
reply(body, options)GmailMessageOdpowiada nadawcy tej wiadomości przy użyciu adresu zwrotnego z opcjonalnymi argumentami.
replyAll(body)GmailMessageOdpowiada nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości.
replyAll(body, options)GmailMessageOdpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, za pomocą: argumentów opcjonalnych.
star()GmailMessageOznacza wiadomość gwiazdką.
unstar()GmailMessageUsuwa gwiazdkę z wiadomości.

Szczegółowa dokumentacja

createDraftReply(body)

Tworzy wersję roboczą wiadomości z adresem zwrotnym, odpowiadając nadawcy tej wiadomości. rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

Parametry

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


createDraftReply(body, options)

Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego argumentów opcjonalnych.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (wraz nagłówki) to limit z ograniczeniami.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringjeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML jeśli masz wbudowane obrazy e-maili
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body)

Tworzy wersję roboczą wiadomości z adresem zwrotnym i wszystkimi adresatami wiadomości, które są wysyłane do nadawcy tę wiadomość. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Parametry

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body, options)

Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (wraz nagłówki) to limit z ograniczeniami.

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringjeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML jeśli masz wbudowane obrazy e-maili
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


forward(recipient)

Powoduje przekazanie tej wiadomości do nowych odbiorców. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

Parametry

NazwaTypOpis
recipientStringRozdzielona przecinkami lista adresów e-mail.

Powrót

GmailMessage – ten komunikat przydaje się w przypadku tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


forward(recipient, options)

Powoduje przekazanie tej wiadomości do nowych odbiorców z opcjonalnymi argumentami.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Parametry

NazwaTypOpis
recipientStringRozdzielona przecinkami lista adresów e-mail.
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringjeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML jeśli masz wbudowane obrazy e-maili
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
noReplyBooleantrue, jeśli e-mail ma być wysłany z ogólnego adresu adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila.
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powrót

GmailMessage – ten komunikat przydaje się w przypadku tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getAttachments()

Pobiera wszystkie załączniki do tej wiadomości.

Powrót

GmailAttachment[] – tablica z załącznikami obiektów blob dla tej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

getAttachments(options)

Pobiera wszystkie załączniki do tej wiadomości.

Parametry

NazwaTypOpis
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
includeInlineImagesBooleantrue, jeśli zwrócona tablica obiektu blob załączniki powinny zawierać obrazy w tekście (domyślnie true).
includeAttachmentsBooleantrue, jeśli zwrócona tablica obiektu blob załączniki powinny zawierać zwykłe (niewbudowane) załączniki (domyślnie true).

Powrót

GmailAttachment[] – tablica z załącznikami obiektów blob dla tej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

getBcc()

Pobiera rozdzielane przecinkami adresatów w polu UDW tej wiadomości.

To pole jest puste w przypadku wszystkich odebranych wiadomości (według definicji).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

Powrót

String – rozdzielane przecinkami adresy odbiorców w polu UDW tej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getBody()

Pobiera treść HTML treści wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

Powrót

String – treść wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getCc()

Pobiera rozdzielane przecinkami adresy odbiorców, których kopia została umieszczona w polu DW tej wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

Powrót

String – rozdzielane przecinkami adresy odbiorców, których adresy DW zostały wysłane do tej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getDate()

Pobiera datę i godzinę wysłania tej wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

Powrót

Date – data i godzina wysłania wiadomości.

Autoryzacja

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

  • https://mail.google.com/

getFrom()

Pobiera nadawcę wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

Powrót

String – adres e-mail nadawcy wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getHeader(name)

Pobiera wartość nagłówka RFC 2822 na podstawie nazwy nagłówka.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

Parametry

NazwaTypOpis
nameStringNazwa nagłówka RFC bez dwukropka oddzielającego go od wartości.

Powrót

String – wartość nagłówka lub pusty ciąg znaków, jeśli w wiadomości nie ma nagłówka.

Autoryzacja

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

  • https://mail.google.com/

getId()

Pobiera identyfikator wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

Powrót

String – identyfikator wiadomości.


getPlainBody()

Pobiera treść wiadomości bez formatowania HTML. To bardziej skomplikowane niż getBody() i zajmuje to dłużej.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

Powrót

String – zwykła treść wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getRawContent()

Pobiera nieprzetworzoną treść wiadomości. To odpowiednik opcji „Pokaż oryginał” w interfejsie Gmaila.

Powrót

String – nieprzetworzona treść wiadomości.

Autoryzacja

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

  • https://mail.google.com/

getReplyTo()

Pobiera adres zwrotny dla tej wiadomości (zwykle jest to adres nadawcy).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

Powrót

String – adres e-mail do odpowiedzi.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getSubject()

Pobiera temat wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

Powrót

String – temat wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


getThread()

Pobiera wątek zawierający tę wiadomość.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

Powrót

GmailThread – wątek GmailThread zawierający tę wiadomość.

Autoryzacja

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

  • https://mail.google.com/

getTo()

Pobiera rozdzielanych przecinkami adresatów tej wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

Powrót

String – rozdzielany przecinkami adresaci tej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


isDraft()

Określa, czy wiadomość jest wersją roboczą.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

Powrót

Boolean – określa, czy wiadomość jest wersją roboczą.

Autoryzacja

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

  • https://mail.google.com/

isInChats()

Określa, czy wiadomość to czat.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

Powrót

Boolean – określa, czy wiadomość jest czatem.


isInInbox()

Określa, czy wiadomość znajduje się w skrzynce odbiorczej.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

Powrót

Boolean – określa, czy wiadomość jest w skrzynce odbiorczej.

Autoryzacja

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

  • https://mail.google.com/

isInPriorityInbox()

Zwraca true, jeśli wiadomość jest w Priorytetach. w przeciwnym razie zwraca false.

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

Powrót

Boolean – określa, czy wiadomość znajduje się w Priorytetach.

Autoryzacja

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

  • https://mail.google.com/

isInTrash()

Określa, czy wiadomość znajduje się w koszu.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

Powrót

Boolean – określa, czy wiadomość znajduje się w koszu.


isStarred()

Określa, czy wiadomość została oznaczona gwiazdką.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

Powrót

Boolean – określa, czy wiadomość jest oznaczona gwiazdką.


isUnread()

Sprawdza, czy wiadomość jest nieprzeczytana.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

Powrót

Boolean – stan nieprzeczytanej wiadomości.

Autoryzacja

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

  • https://mail.google.com/

markRead()

Oznacza wiadomość jako przeczytaną.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

Powrót

GmailMessage – ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


markUnread()

Oznacza wiadomość jako nieprzeczytaną.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

Powrót

GmailMessage – ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


moveToTrash()

Przenosi wiadomość do kosza.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

Powrót

GmailMessage – ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


refresh()

Ponownie wczytuje tę wiadomość i powiązany z nią stan z Gmaila (przydatne, gdy etykiety, stan odczytu itp., uległy zmianie).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

Powrót

GmailMessage – komunikat dotyczący tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

reply(body)

Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

Parametry

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailMessage – ten komunikat przydaje się w przypadku tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


reply(body, options)

Odpowiada nadawcy tej wiadomości przy użyciu adresu zwrotnego z opcjonalnymi argumentami.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringjeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML jeśli masz wbudowane obrazy e-maili
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
noReplyBooleantrue, jeśli e-mail ma być wysłany z ogólnego adresu adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila.
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powrót

GmailMessage – ten komunikat przydaje się w przypadku tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


replyAll(body)

Odpowiada nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości. Rozmiar wiadomości (w tym nagłówki) są ograniczone.

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

Parametry

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailMessage – ta wiadomość przydaje się podczas tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


replyAll(body, options)

Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, za pomocą: argumentów opcjonalnych.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[] tablica plików do wysłania e-mailem
bccStringrozdzielana przecinkami lista adresów e-mail do pola UDW
ccStringrozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości
fromStringadres, z którego ma zostać wysłany e-mail (musi to być jeden z nich) wartości zwróconych przez funkcję GmailApp.getAliases()
htmlBodyStringjeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML jeśli masz wbudowane obrazy e-maili
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) do danych zdjęcia (BlobSource); przy założeniu, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika);
noReplyBooleantrue, jeśli e-mail ma być wysłany z ogólnego adresu adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila.
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powrót

GmailMessage – ten komunikat przydaje się w przypadku tworzenia łańcuchów.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


star()

Oznacza wiadomość gwiazdką.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

Powrót

GmailMessage – ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też


unstar()

Usuwa gwiazdkę z wiadomości.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

Powrót

GmailMessage – ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.

Autoryzacja

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

  • https://mail.google.com/

Zobacz też