Class GmailMessage

GmailMessage

wiadomość na koncie Gmail użytkownika.

Metody

Metoda	Zwracany typ	Krótki opis
createDraftReply(body)	GmailDraft	Tworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając adresu zwrotnego.
createDraftReply(body, options)	GmailDraft	Tworzy wersję roboczą wiadomości, która jest odpowiedzią na wiadomość nadawcy, z adresem zwrotnym i opcjonalnymi argumentami.
createDraftReplyAll(body)	GmailDraft	Tworzy wersję roboczą wiadomości, która jest odpowiedzią na wiadomość nadawcy, i wysyła ją na adres zwrotny oraz do wszystkich adresatów tej wiadomości.
createDraftReplyAll(body, options)	GmailDraft	Tworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich adresatów z opcjonalnymi argumentami.
forward(recipient)	GmailMessage	Przesyła tę wiadomość do nowych odbiorców.
forward(recipient, options)	GmailMessage	Przesyła tę wiadomość do nowych adresató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()	String	Pobiera listę adresatów UDW oddzielonych przecinkami, którzy otrzymają tę wiadomość.
getBody()	String	Pobiera zawartość HTML treści wiadomości.
getCc()	String	Pobiera listę adresatów w polu DW, oddzielonych przecinkami.
getDate()	Date	Pobiera datę i godzinę tego komunikatu.
getFrom()	String	Zwraca nadawcę tej wiadomości.
getHeader(name)	String	Pobiera wartość nagłówka RFC 2822 na podstawie jego nazwy.
getId()	String	Pobiera identyfikator tej wiadomości.
getPlainBody()	String	Pobiera treść treści wiadomości bez formatowania HTML.
getRawContent()	String	Pobiera surową treść wiadomości.
getReplyTo()	String	Pobiera adres zwrotny tej wiadomości (zwykle nadawcy).
getSubject()	String	Pobiera temat wiadomości.
getThread()	GmailThread	Pobiera wątku zawierającego tę wiadomość.
getTo()	String	Pobiera listę adresatów tej wiadomości, rozdzielonych przecinkami.
isDraft()	Boolean	Określa, czy wiadomość jest wersją roboczą.
isInChats()	Boolean	Określa, czy wiadomość jest czatem.
isInInbox()	Boolean	Określa, czy wiadomość znajduje się w skrzynce odbiorczej.
isInPriorityInbox()	Boolean	Zwraca wartość true, jeśli wiadomość znajduje się w skrzynce priorytetowej, w przeciwnym razie zwraca wartość false.
isInTrash()	Boolean	Określa, czy wiadomość znajduje się 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	Przenosi wiadomość do kosza.
refresh()	GmailMessage	Ponowne załadowanie tej wiadomości i powiązanego stanu z Gmaila (przydatne, gdy zmieniły się etykiety, stan odczytania itp.).
reply(body)	GmailMessage	Odpowiedzi na wiadomość wysłane do nadawcy za pomocą adresu „Na adres”
reply(body, options)	GmailMessage	Odpowiedź dla nadawcy tej wiadomości z adresem zwrotnym i opcjonalnymi argumentami.
replyAll(body)	GmailMessage	Odpowiedzi na wiadomość są wysyłane do nadawcy i wszystkich adresatów, korzystając z adresu zwrotnego.
replyAll(body, options)	GmailMessage	Odpowiedzi na wiadomość wysłane do nadawcy przy użyciu adresu zwrotnego i wszystkich adresatów z opcjonalnymi argumentami.
star()	GmailMessage	Oznaczy wiadomość gwiazdką.
unstar()	GmailMessage	usuwa gwiazdkę z wiadomości.

Szczegółowa dokumentacja

createDraftReply(body)

Tworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając adresu zwrotnego. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit miejsca.

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

Parametry

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

Powrót

GmailDraft – nowo utworzona wersja robocza 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/

Zobacz też

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

---

createDraftReply(body, options)

Tworzy wersję roboczą wiadomości, która jest odpowiedzią na wiadomość nadawcy, z adresem zwrotnym i opcjonalnymi argumentami.

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

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	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 GmailApp.getAliases()
htmlBody	String	jeśli jest ustawiony, urządzenia z możliwością renderowania kodu HTML używają go zamiast wymaganego argumentu body; w sposób opcjonalny możesz dodać pole inlineImages w sekcji body kodu HTML, jeśli w e-mailu masz wstawione obrazy
inlineImages	Object	obiekt 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" />
name	String	nazwa nadawcy e-maila (domyślnie imię i nazwisko 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 (maksymalnie 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza 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/

Zobacz też

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

---

createDraftReplyAll(body)

Tworzy wersję roboczą wiadomości, która jest odpowiedzią na wiadomość nadawcy, i wysyła ją na adres zwrotny oraz do wszystkich adresatów tej wiadomości. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit konty.

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

Parametry

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

Powrót

GmailDraft – nowo utworzona wersja robocza 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/

Zobacz też

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

---

createDraftReplyAll(body, options)

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

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

// Create a draft response to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	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 GmailApp.getAliases()
htmlBody	String	jeśli jest ustawiony, urządzenia z możliwością renderowania kodu HTML używają go zamiast wymaganego argumentu body; w sposób opcjonalny możesz dodać pole inlineImages w sekcji body kodu HTML, jeśli w e-mailu masz wstawione obrazy
inlineImages	Object	obiekt 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" />
name	String	nazwa nadawcy e-maila (domyślnie imię i nazwisko 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 (maksymalnie 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza 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/

Zobacz też

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

---

forward(recipient)

Przesyła tę wiadomość do nowych odbiorców. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit konty.

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

Parametry

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

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

• forward(recipient, options)

---

forward(recipient, options)

Przesyła tę wiadomość do nowych adresatów z opcjonalnymi argumentami.

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	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 GmailApp.getAliases()
htmlBody	String	jeśli jest ustawiony, urządzenia z możliwością renderowania kodu HTML używają go zamiast wymaganego argumentu body; w sposób opcjonalny możesz dodać pole inlineImages w sekcji body kodu HTML, jeśli w e-mailu masz wstawione obrazy
inlineImages	Object	obiekt 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" />
name	String	nazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
noReply	Boolean	true czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
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).

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

• forward(recipient)

---

getAttachments()

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

Powrót

GmailAttachment[] – tablica załączników typu Blob dla tej 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/

---

getAttachments(options)

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

Parametry

Nazwa	Typ	Opis
options	Object	Obiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

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

Powrót

GmailAttachment[] – tablica załączników typu Blob dla tej 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/

---

getBcc()

Pobiera listę adresatów UDW oddzielonych przecinkami, którzy otrzymają tę wiadomość.

Według definicji jest pusty w przypadku wszystkich otrzymanych wiadomości.

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

Powrót

String – oddzieloni przecinkami adresaci w polu UDW tej 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/

Zobacz też

• getTo()

---

getBody()

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

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

Powrót

String – treść 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/

Zobacz też

• getSubject()

---

getCc()

Pobiera listę adresatów w polu DW, oddzielonych przecinkami.

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

Powrót

String – oddzieloni przecinkami adresaci w polu DW tej 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/

Zobacz też

• getTo()

---

getDate()

Pobiera datę i godzinę tego komunikatu.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 tej 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/

---

getFrom()

Zwraca nadawcę tej wiadomości.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

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ż

• getReplyTo()

---

getHeader(name)

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const 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 dwukropka oddzielającego go od wartości.

Powrót

String – wartość nagłówka lub pusty ciąg znaków, jeśli nagłówek nie istnieje w 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/

---

getId()

Pobiera identyfikator tej wiadomości.

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

Powrót

String – identyfikator wiadomości.

---

getPlainBody()

Pobiera treść treści wiadomości bez formatowania HTML. Jest to bardziej skomplikowane niż getBody() i zajmuje więcej czasu.

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

Powrót

String – zwykła treść tej 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/

Zobacz też

• getSubject()

---

getRawContent()

Pobiera surową treść wiadomości. Jest to równoznaczne z opcją „Pokaż oryginał” w interfejsie Gmaila.

Powrót

String – nieprzetworzona treść 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/

---

getReplyTo()

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

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

Powrót

String – adres e-mail do wysyłania odpowiedzi.

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ż

• getCc()

---

getSubject()

Pobiera temat wiadomości.

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

Powrót

String – temat tej 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/

Zobacz też

• getAttachments()

---

getThread()

Pobiera wątku zawierającego tę wiadomość.

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

Powrót

GmailThread – wątek Gmaila zawierający tę 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/

---

getTo()

Pobiera listę adresatów tej wiadomości, rozdzielonych przecinkami.

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

Powrót

String – odbiorcy tej wiadomości oddzieloni przecinkami.

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ż

• getCc()

---

isDraft()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

Powrót

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

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/

---

isInChats()

Określa, czy wiadomość jest czatem.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is a chat? ${message.isInChats()}`);

Powrót

Boolean – czy wiadomość jest czatem.

---

isInInbox()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in inbox? ${message.isInInbox()}`);

Powrót

Boolean – czy wiadomość znajduje się w skrzynce odbiorczej.

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/

---

isInPriorityInbox()

Zwraca wartość true, jeśli wiadomość znajduje się w skrzynce priorytetowej, w przeciwnym razie zwraca wartość false.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let 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 – czy ta wiadomość znajduje się w skrzynce priorytetowej.

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/

---

isInTrash()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

Powrót

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

---

isStarred()

Określa, czy wiadomość jest oznaczona gwiazdką.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is starred? ${message.isStarred()}`);

Powrót

Boolean – czy ta wiadomość jest oznaczona gwiazdką.

---

isUnread()

Określa, czy wiadomość jest nieprzeczytana.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is unread? ${message.isUnread()}`);

Powrót

Boolean – stan nieprzeczytanej 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/

---

markRead()

Oznacza wiadomość jako przeczytaną.

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

Powrót

GmailMessage – ta wiadomość Gmail jest przydatna do łańcuchowania.

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ż

• isUnread()

---

markUnread()

Oznacza wiadomość jako nieprzeczytaną.

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

Powrót

GmailMessage – ta wiadomość Gmail jest przydatna do łańcuchowania.

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ż

• isUnread()

---

moveToTrash()

Przenosi wiadomość do kosza.

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

Powrót

GmailMessage – ta wiadomość Gmail jest przydatna do łańcuchowania.

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ż

• isInTrash()

---

refresh()

Ponowne załadowanie tej wiadomości i powiązanego stanu z Gmaila (przydatne, gdy zmieniły się etykiety, stan odczytania itp.).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 – ta wiadomość jest dołączana do innych 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/

---

reply(body)

Odpowiedzi na wiadomość wysłane do nadawcy za pomocą adresu „Na adres” Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit.

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

Parametry

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

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

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

---

reply(body, options)

Odpowiedź dla nadawcy tej wiadomości z adresem zwrotnym i opcjonalnymi argumentami.

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

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	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 GmailApp.getAliases()
htmlBody	String	jeśli jest ustawiony, urządzenia z możliwością renderowania kodu HTML używają go zamiast wymaganego argumentu body; w sposób opcjonalny możesz dodać pole inlineImages w sekcji body kodu HTML, jeśli w e-mailu masz wstawione obrazy
inlineImages	Object	obiekt 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" />
name	String	nazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
noReply	Boolean	true czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
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).

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

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

---

replyAll(body)

Odpowiedzi na wiadomość są wysyłane do nadawcy i wszystkich adresatów, korzystając z adresu zwrotnego. Rozmiar e-maila (w tym nagłówków) jest ograniczony przez limit kontyngentu.

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

Parametry

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

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

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

---

replyAll(body, options)

Odpowiedzi na wiadomość wysłane do nadawcy przy użyciu adresu zwrotnego i wszystkich adresatów z opcjonalnymi argumentami.

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

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.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 JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
attachments	BlobSource[]	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 GmailApp.getAliases()
htmlBody	String	jeśli jest ustawiony, urządzenia z możliwością renderowania kodu HTML używają go zamiast wymaganego argumentu body; w sposób opcjonalny możesz dodać pole inlineImages w sekcji body kodu HTML, jeśli w e-mailu masz wstawione obrazy
inlineImages	Object	obiekt 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" />
name	String	nazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
noReply	Boolean	true czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
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).

Powrót

GmailMessage – ta wiadomość jest przydatna do łańcuchowania.

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ż

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

---

star()

Oznaczy wiadomość gwiazdką.

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

Powrót

GmailMessage – ta wiadomość Gmail jest przydatna do łańcuchowania.

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ż

• unstar()

---

unstar()

usuwa gwiazdkę z wiadomości.

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

Powrót

GmailMessage – ta wiadomość Gmail jest przydatna do łańcuchowania.

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ż

• star()