Class GmailMessage

Wiadomość w Gmailu

Wiadomość na koncie Gmail użytkownika.

Metody

Metoda	Zwracany typ	Krótki opis
createDraftReply(body)	GmailDraft	Tworzy wersję roboczą wiadomości, która odpowiada na wiadomość nadawcy, używając adresu zwrotnego.
createDraftReply(body, options)	GmailDraft	Tworzy wersję roboczą wiadomości wysyłanej do nadawcy tej wiadomości z użyciem adresu zwrotnego z opcjonalnymi argumentami.
createDraftReplyAll(body)	GmailDraft	Tworzy wersję roboczą wiadomości skierowanej do nadawcy, używając adresu zwrotnego i wszystkich adresatów tej wiadomości.
createDraftReplyAll(body, options)	GmailDraft	Tworzy wersję roboczą wiadomości wysyłanej do nadawcy tej wiadomości z użyciem adresu zwrotnego i wszystkich adresatów oraz opcjonalnych argumentów.
forward(recipient)	GmailMessage	Przekazuje tę wiadomość do nowych odbiorców.
forward(recipient, options)	GmailMessage	Powoduje przekazanie tej wiadomości do nowych odbiorców i opcjonalnych argumentów.
getAttachments()	GmailAttachment[]	Pobiera wszystkie załączniki do tej wiadomości.
getAttachments(options)	GmailAttachment[]	Pobiera wszystkie załączniki do tej wiadomości.
getBcc()	String	Pobiera odbiorców UDW dla tej wiadomości.
getBody()	String	Pobiera treść HTML treści wiadomości.
getCc()	String	Pobiera adresatów wiadomości rozdzielonych przecinkami (DW) tej wiadomości.
getDate()	Date	Pobiera datę i godzinę tej wiadomości.
getFrom()	String	Pobiera nadawcę tej wiadomości.
getHeader(name)	String	Pobiera wartość nagłówka RFC 2822 po nazwie.
getId()	String	Pobiera identyfikator tej wiadomości.
getPlainBody()	String	Pobiera treść tej wiadomości bez formatowania HTML.
getRawContent()	String	Pobiera nieprzetworzoną treść tej wiadomości.
getReplyTo()	String	Pobiera adres zwrotny tej wiadomości (zazwyczaj nadawcy).
getSubject()	String	Pobiera temat tej wiadomości.
getThread()	GmailThread	Pobiera wątek zawierający tę wiadomość.
getTo()	String	Pobiera odbiorców wiadomości rozdzielonych przecinkami.
isDraft()	Boolean	Określa, czy wiadomość jest wersją roboczą.
isInChats()	Boolean	Sprawdza, czy ta wiadomość jest czatem.
isInInbox()	Boolean	Sprawdza, czy ta wiadomość jest w skrzynce odbiorczej.
isInPriorityInbox()	Boolean	Zwraca wartość true, jeśli ta wiadomość znajduje się w folderze Priorytety. W przeciwnym razie zwraca false.
isInTrash()	Boolean	Sprawdza, czy wiadomość jest w koszu.
isStarred()	Boolean	Określa, czy wiadomość jest oznaczona gwiazdką.
isUnread()	Boolean	Określa, czy wiadomość jest nieprzeczytana.
markRead()	GmailMessage	Oznacza wiadomość jako przeczytaną.
markUnread()	GmailMessage	Oznacza wiadomość jako nieprzeczytaną.
moveToTrash()	GmailMessage	Powoduje przeniesienie wiadomości do kosza.
refresh()	GmailMessage	Wczytuje ponownie tę wiadomość i powiązany stan z Gmaila (na wypadek, gdyby etykiety, stan odczytu itp. uległy zmianie).
reply(body)	GmailMessage	Odpowiedzi do nadawcy tej wiadomości z wykorzystaniem adresu zwrotnego.
reply(body, options)	GmailMessage	Odpowiedzi do nadawcy tej wiadomości z adresem zwrotnym i opcjonalnymi argumentami.
replyAll(body)	GmailMessage	Odpowiedzi do nadawcy przy użyciu adresu zwrotnego i wszystkich odbiorców wiadomości.
replyAll(body, options)	GmailMessage	Odpowiedzi dla nadawcy tej wiadomości z wykorzystaniem adresu zwrotnego i wszystkich adresatów oraz opcjonalnych argumentów.
star()	GmailMessage	Oznaczy wiadomość gwiazdką.
unstar()	GmailMessage	Oznaczenie wiadomości gwiazdką zostanie usunięte.

Szczegółowa dokumentacja

createDraftReply(body)

Tworzy wersję roboczą wiadomości, która odpowiada na wiadomość nadawcy, używając adresu zwrotnego. Rozmiar e-maila (w tym nagłówków) 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

Nazwa	Typ	Opis
body	String	Treść e-maila.

Zwróć

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

Tworzy wersję roboczą wiadomości wysyłanej do nadawcy tej wiadomości z użyciem adresu zwrotnego z opcjonalnymi argumentami.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (w tym nagłówków) jest ograniczony.

// 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: "[e-mail]"
});

Parametry

Nazwa	Typ	Opis
body	String	Treść e-maila.
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablica plików do wysłania w wiadomości e-mail
bcc	String	oddzielona przecinkami lista adresów e-mail w polu UDW.
cc	String	oddzielona przecinkami lista adresów e-mail dla adresatów w polu DW.
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 skonfigurowana, urządzenia, które mogą renderować kod HTML, używają go zamiast wymaganego argumentu body. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wbudowane obrazy do e-maila.
inlineImages	Object	obiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy, że używany jest parametr htmlBody i 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);
subject	String	nowy wiersz tematu e-maila

Zwróć

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

Tworzy wersję roboczą wiadomości skierowanej do nadawcy, używając adresu zwrotnego i wszystkich adresatów tej wiadomości. Rozmiar e-maila (w tym nagłówków) 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

Nazwa	Typ	Opis
body	String	Treść e-maila.

Zwróć

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body, options)

Tworzy wersję roboczą wiadomości wysyłanej do nadawcy tej wiadomości z użyciem adresu zwrotnego i wszystkich adresatów oraz opcjonalnych argumentów.

E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (w tym nagłówków) jest ograniczony.

// 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: "[e-mail]"
});

Parametry

Nazwa	Typ	Opis
body	String	Treść e-maila.
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablica plików do wysłania w wiadomości e-mail
bcc	String	oddzielona przecinkami lista adresów e-mail w polu UDW.
cc	String	oddzielona przecinkami lista adresów e-mail dla adresatów w polu DW.
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 skonfigurowana, urządzenia, które mogą renderować kod HTML, używają go zamiast wymaganego argumentu body. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wbudowane obrazy do e-maila.
inlineImages	Object	obiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy, że używany jest parametr htmlBody i 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);
subject	String	nowy wiersz tematu e-maila

Zwróć

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

forward(recipient)

Przekazuje tę wiadomość do nowych odbiorców. Rozmiar e-maila (w tym nagłówków) 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("[e-mail],[e-mail]");

Parametry

Nazwa	Typ	Opis
recipient	String	Lista adresów e-mail rozdzielonych przecinkami.

Zwróć

GmailMessage – ta wiadomość jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• forward(recipient, options)

---

forward(recipient, options)

Powoduje przekazanie tej wiadomości do nowych odbiorców i opcjonalnych argumentów.

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

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("[e-mail],[e-mail]", {
  cc: "[e-mail]",
  bcc: "[e-mail],[e-mail]"
});

Parametry

Nazwa	Typ	Opis
recipient	String	Lista adresów e-mail rozdzielonych przecinkami.
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablica plików do wysłania w wiadomości e-mail
bcc	String	oddzielona przecinkami lista adresów e-mail w polu UDW.
cc	String	oddzielona przecinkami lista adresów e-mail dla adresatów w polu DW.
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 skonfigurowana, urządzenia, które mogą renderować kod HTML, używają go zamiast wymaganego argumentu body. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wbudowane obrazy do e-maila.
inlineImages	Object	obiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy, że używany jest parametr htmlBody i odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
name	String	nazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReply	Boolean	true, jeśli chcesz, by e-maile były wysyłane z ogólnego adresu e-mail, który ma zniechęcać odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie na kontach Gmail.
replyTo	String	adres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subject	String	nowy wiersz tematu e-maila

Zwróć

GmailMessage – ta wiadomość jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• forward(recipient)

---

getAttachments()

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

Zwróć

GmailAttachment[] – tablica załączników Blob tej wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getAttachments(options)

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

Parametry

Nazwa	Typ	Opis
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
includeInlineImages	Boolean	true, jeśli zwrócona tablica załączników Blob powinna zawierać obrazy w tekście (domyślnie true).
includeAttachments	Boolean	true, jeśli zwrócona tablica załączników Blob powinna zawierać zwykłe załączniki (nie wbudowane) (domyślnie true).

Zwróć

GmailAttachment[] – tablica załączników Blob tej wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getBcc()

Pobiera odbiorców UDW dla 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

Zwróć

String – odbiorcy wiadomości rozdzielonych przecinkami (bcc'd).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getTo()

---

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

Zwróć

String – treść wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getSubject()

---

getCc()

Pobiera adresatów wiadomości rozdzielonych przecinkami (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

Zwróć

String – odbiorcy wiadomości rozdzielone przecinkami (DW) tej wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getTo()

---

getDate()

Pobiera datę i godzinę 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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getFrom()

Pobiera nadawcę 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.getFrom()); // Log from address of the message

Zwróć

String – adres e-mail nadawcy wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getReplyTo()

---

getHeader(name)

Pobiera wartość nagłówka RFC 2822 po nazwie.

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

Nazwa	Typ	Opis
name	String	Nazwa nagłówka RFC bez dwukropku oddzielającego go od wartości.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getId()

Pobiera identyfikator tej 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

Zwróć

String – identyfikator wiadomości;

---

getPlainBody()

Pobiera treść tej wiadomości bez formatowania HTML. To bardziej złożone niżgetBody() i trwa 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

Zwróć

String – zwykły tekst wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getSubject()

---

getRawContent()

Pobiera nieprzetworzoną treść tej wiadomości. Odpowiednik funkcji „Pokaż oryginał” w interfejsie Gmaila.

Zwróć

String – nieprzetworzona treść tej wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getReplyTo()

Pobiera adres zwrotny tej wiadomości (zazwyczaj 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

Zwróć

String – adres e-mail do odpowiedzi.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getCc()

---

getSubject()

Pobiera temat 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.getSubject()); // Log subject line

Zwróć

String – temat wiadomości;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getAttachments()

---

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

getTo()

Pobiera odbiorców wiadomości rozdzielonych przecinkami.

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

Zwróć

String – odbiorcy wiadomości rozdzielone przecinkami;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• getCc()

---

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());

Zwróć

Boolean – wskazuje, czy ta wiadomość jest wersją roboczą.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

isInChats()

Sprawdza, czy ta wiadomość jest czatem.

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());

Zwróć

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

---

isInInbox()

Sprawdza, czy ta wiadomość jest 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());

Zwróć

Boolean – informacja o tym, czy ta wiadomość znajduje się w Odebranych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

isInPriorityInbox()

Zwraca wartość true, jeśli ta wiadomość znajduje się w folderze Priorytety. 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());
}

Zwróć

Boolean – informacja o tym, czy ta wiadomość znajduje się w folderze Priorytety.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

isInTrash()

Sprawdza, czy wiadomość jest 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());

Zwróć

Boolean – informacja, czy wiadomość jest w koszu;

---

isStarred()

Określa, czy wiadomość jest 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());

Zwróć

Boolean – informacja, czy wiadomość jest oznaczona gwiazdką;

---

isUnread()

Określa, 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());

Zwróć

Boolean – stan nieprzeczytanej wiadomości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie 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

Zwróć

GmailMessage – ta wiadomość z Gmaila jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• isUnread()

---

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

Zwróć

GmailMessage – ta wiadomość z Gmaila jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• isUnread()

---

moveToTrash()

Powoduje przeniesienie wiadomości 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

Zwróć

GmailMessage – ta wiadomość z Gmaila jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• isInTrash()

---

refresh()

Wczytuje ponownie tę wiadomość i powiązany stan z Gmaila (na wypadek, gdyby 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

Zwróć

GmailMessage – ten komunikat jest powiązany z łańcuchami.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

---

reply(body)

Odpowiedzi do nadawcy tej wiadomości z wykorzystaniem adresu zwrotnego. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

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

Nazwa	Typ	Opis
body	String	Treść e-maila.

Zwróć

GmailMessage – ta wiadomość jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

Odpowiedzi do nadawcy tej wiadomości z adresem zwrotnym i opcjonalnymi argumentami.

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

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

Nazwa	Typ	Opis
body	String	Treść e-maila.
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablica plików do wysłania w wiadomości e-mail
bcc	String	oddzielona przecinkami lista adresów e-mail w polu UDW.
cc	String	oddzielona przecinkami lista adresów e-mail dla adresatów w polu DW.
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 skonfigurowana, urządzenia, które mogą renderować kod HTML, używają go zamiast wymaganego argumentu body. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wbudowane obrazy do e-maila.
inlineImages	Object	obiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy, że używany jest parametr htmlBody i odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
name	String	nazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReply	Boolean	true, jeśli chcesz, by e-maile były wysyłane z ogólnego adresu e-mail, który ma zniechęcać odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie na kontach Gmail.
replyTo	String	adres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subject	String	nowy wiersz tematu e-maila

Zwróć

GmailMessage – ta wiadomość jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

Odpowiedzi do nadawcy przy użyciu adresu zwrotnego i wszystkich odbiorców wiadomości. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.

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

Nazwa	Typ	Opis
body	String	Treść e-maila.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body)
• reply(body, options)
• replyAll(body, options)

---

replyAll(body, options)

Odpowiedzi dla nadawcy tej wiadomości z wykorzystaniem adresu zwrotnego i wszystkich adresatów oraz opcjonalnych argumentów.

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

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

Nazwa	Typ	Opis
body	String	Treść e-maila.
options	Object	Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	tablica plików do wysłania w wiadomości e-mail
bcc	String	oddzielona przecinkami lista adresów e-mail w polu UDW.
cc	String	oddzielona przecinkami lista adresów e-mail dla adresatów w polu DW.
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 skonfigurowana, urządzenia, które mogą renderować kod HTML, używają go zamiast wymaganego argumentu body. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz wbudowane obrazy do e-maila.
inlineImages	Object	obiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy, że używany jest parametr htmlBody i odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
name	String	nazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReply	Boolean	true, jeśli chcesz, by e-maile były wysyłane z ogólnego adresu e-mail, który ma zniechęcać odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie na kontach Gmail.
replyTo	String	adres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subject	String	nowy wiersz tematu e-maila (maksymalnie 250 znaków),

Zwróć

GmailMessage – ta wiadomość jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• reply(body)
• reply(body, options)
• replyAll(body)

---

star()

Oznaczy 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

Zwróć

GmailMessage – ta wiadomość z Gmaila jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• unstar()

---

unstar()

Oznaczenie wiadomości gwiazdką zostanie usunięte.

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

Zwróć

GmailMessage – ta wiadomość z Gmaila jest przydatna w przypadku łańcuchów.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów lub odpowiednich zakresów w powiązanym interfejsie API REST:

• https://mail.google.com/

Zobacz też

• star()