Class GmailMessage

GmailMessage

Wiadomość na koncie Gmail użytkownika.

Metody

MetodaZwracany typKrótki opis
createDraftReply(body)GmailDraftTworzy wersję roboczą wiadomości, odpowiadając nadawcy na tę wiadomość przy użyciu adresu zwrotnego.
createDraftReply(body, options)GmailDraftTworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając adresu zwrotnego z opcjonalnymi argumentami.
createDraftReplyAll(body)GmailDraftTworzy wersję roboczą wiadomości, która odpowiada nadawcy z użyciem adresu zwrotnego i wszystkich odbiorców tej wiadomości.
createDraftReplyAll(body, options)GmailDraftTworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami.
forward(recipient)GmailMessagePrzekazuje tę wiadomość do nowych odbiorców.
forward(recipient, options)GmailMessagePrzekazuje 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()StringPobiera adresatów, którzy zostali dodani do wiadomości (UDW).
getBody()StringPobiera treść HTML tej wiadomości.
getCc()StringPobiera adresatów rozdzielonych przecinkami, których kopia została utworzona w polu DW tej wiadomości.
getDate()DatePobiera datę i godzinę tej wiadomości.
getFrom()StringPobiera nadawcę tej wiadomości.
getHeader(name)StringPobiera wartość nagłówka RFC 2822 z nazwą nagłówka.
getId()StringPobiera identyfikator tej wiadomości.
getPlainBody()StringPobiera treść tej wiadomości bez formatowania HTML.
getRawContent()StringPobiera nieprzetworzoną treść tej wiadomości.
getReplyTo()StringPobiera adres zwrotny tej wiadomości (zwykle nadawcy).
getSubject()StringPobiera temat tej wiadomości.
getThread()GmailThreadPobiera wątek zawierający tę wiadomość.
getTo()StringPobiera adresatów tej wiadomości rozdzielonych przecinkami.
isDraft()BooleanWskazuje, czy wiadomość jest wersją roboczą.
isInChats()BooleanSprawdza, czy wiadomość jest czatem.
isInInbox()BooleanWskazuje, czy wiadomość znajduje się w skrzynce odbiorczej.
isInPriorityInbox()BooleanZwraca wartość true, jeśli ta wiadomość znajduje się w skrzynce odbiorczej Priorytety. W przeciwnym razie zwraca wartość false.
isInTrash()BooleanSprawdza, czy wiadomość znajduje się w koszu.
isStarred()BooleanWskazuje, czy wiadomość jest oznaczona gwiazdką.
isUnread()BooleanWskazuje, czy wiadomość jest nieprzeczytana.
markRead()GmailMessageOznacza wiadomość jako przeczytaną.
markUnread()GmailMessageOznacza wiadomość jako nieprzeczytaną.
moveToTrash()GmailMessagePrzenosi wiadomość do kosza.
refresh()GmailMessageWczytuje ponownie tę wiadomość i powiązany stan z Gmaila (przydatne w przypadku zmiany etykiet, stanu odczytu itp.).
reply(body)GmailMessageOdpowiada nadawcy tej wiadomości przy użyciu 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 z użyciem adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami.
star()GmailMessageoznacza wiadomość gwiazdką.
unstar()GmailMessageUsuwa gwiazdkę z wiadomości.

Szczegółowa dokumentacja

createDraftReply(body)

Tworzy wersję roboczą wiadomości, odpowiadając nadawcy na tę wiadomość przy użyciu adresu zwrotnego. 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.

Powroty

GmailDraft – nowo utworzona wersja robocza wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


createDraftReply(body, options)

Tworzy wersję roboczą wiadomości, która odpowiada nadawcy tej wiadomości, używając 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) 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: "another@example.com"
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringgdy jest ustawione, urządzenia mogące renderować kod HTML używają go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz obrazy w treści e-maila.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powroty

GmailDraft – nowo utworzona wersja robocza wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body)

Tworzy wersję roboczą wiadomości, która odpowiada nadawcy z użyciem adresu zwrotnego i wszystkich odbiorców tej wiadomości. 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.

Powroty

GmailDraft – nowo utworzona wersja robocza wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body, options)

Tworzy wersję roboczą wiadomości, która odpowiada 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 z nagłówkami) 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: "another@example.com"
});

Parametry

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringgdy jest ustawione, urządzenia mogące renderować kod HTML używają go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz obrazy w treści e-maila.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powroty

GmailDraft – nowo utworzona wersja robocza wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


forward(recipient)

Przekazuje tę wiadomość 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
recipientStringLista adresów e-mail rozdzielonych przecinkami.

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


forward(recipient, options)

Przekazuje tę wiadomość do nowych adresató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) jest ograniczony.

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
recipientStringLista adresów e-mail rozdzielonych przecinkami.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringgdy jest ustawione, urządzenia mogące renderować kod HTML używają go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz obrazy w treści e-maila.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReplyBooleantrue, jeśli e-mail powinien zostać wysłany z ogólnego adresu e-mail służącego do wysyłania wiadomości tylko w celu zniechęcenia odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie użytkowników Gmaila.
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


getAttachments()

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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

getAttachments(options)

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

Parametry

NazwaTypOpis
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
includeInlineImagesBooleantrue, jeśli zwrócona tablica załączników Blob powinna zawierać obrazy w tekście (wartość domyślna to true).
includeAttachmentsBooleantrue, jeśli zwrócona tablica załączników Blob powinna zawierać zwykłe (niewbudowane) załączniki (domyślnie jest to true).

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

getBcc()

Pobiera adresatów, którzy zostali dodani do wiadomości (UDW).

To pole jest z definicji puste w przypadku wszystkich odebranych 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.getBcc()); // Log bcc'd addresses

Powroty

String – adresaci oddzieleni przecinkami, którzy dodali ukrytą kopię wiadomości do tej wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


getBody()

Pobiera treść HTML 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.getBody()); // Log contents of the body

Powroty

String – treść wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


getCc()

Pobiera adresatów rozdzielonych przecinkami, których kopia została utworzona 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

Powroty

String – adresaci oddzieleni przecinkami, w polu DW wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


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

Powroty

Date – data i godzina tej wiadomości.

Upoważnienie

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

  • 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

Powroty

String – adres e-mail nadawcy wiadomości.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


getHeader(name)

Pobiera wartość nagłówka RFC 2822 z nazwą 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.

Powroty

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

Upoważnienie

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

  • 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

Powroty

String – identyfikator wiadomości.


getPlainBody()

Pobiera treść tej wiadomości bez formatowania HTML. Jest 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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


getRawContent()

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

Powroty

String – nieprzetworzona treść wiadomości,

Upoważnienie

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

  • https://mail.google.com/

getReplyTo()

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

Powroty

String – adres e-mail do odpowiedzi.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


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

Powroty

String – temat wiadomości.

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

getTo()

Pobiera adresatów tej 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

Powroty

String – adresaci tej wiadomości rozdzielone przecinkami.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


isDraft()

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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

isInChats()

Sprawdza, czy 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());

Powroty

Boolean – czy wiadomość jest czatem.


isInInbox()

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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

isInPriorityInbox()

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

Powroty

Boolean – określa, czy wiadomość znajduje się w skrzynce odbiorczej Priorytety.

Upoważnienie

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

  • https://mail.google.com/

isInTrash()

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

Powroty

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


isStarred()

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

Powroty

Boolean – czy wiadomość jest oznaczona gwiazdką.


isUnread()

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

Powroty

Boolean – stan nieprzeczytanej wiadomości.

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


refresh()

Wczytuje ponownie tę wiadomość i powiązany stan z Gmaila (przydatne w przypadku zmiany etykiet, stanu odczytu itp.).

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

Powroty

GmailMessage – komunikat związany z tworzeniem łańcuchów.

Upoważnienie

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

  • https://mail.google.com/

reply(body)

Odpowiada nadawcy tej wiadomości przy użyciu 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

NazwaTypOpis
bodyStringTreść e-maila.

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • 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) 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

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringgdy jest ustawione, urządzenia mogące renderować kod HTML używają go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz obrazy w treści e-maila.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReplyBooleantrue, jeśli e-mail powinien zostać wysłany z ogólnego adresu e-mail służącego do wysyłania wiadomości tylko w celu zniechęcenia odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie użytkowników Gmaila.
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


replyAll(body)

Odpowiada nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej 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

NazwaTypOpis
bodyStringTreść e-maila.

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • https://mail.google.com/

Zobacz też


replyAll(body, options)

Odpowiada nadawcy tej wiadomości z użyciem 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 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

NazwaTypOpis
bodyStringTreść e-maila.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania w e-mailu.
bccStringrozdzielaną przecinkami listę adresów e-mail, które mają zostać wysłane do UDW
ccStringoddziel adresy e-mail przecinkami
fromStringAdres, z którego należy wysłać e-maila. Musi on być jedną z wartości zwracanych przez funkcję GmailApp.getAliases().
htmlBodyStringgdy jest ustawione, urządzenia mogące renderować kod HTML używają go zamiast wymaganego argumentu treści. Możesz dodać opcjonalne pole inlineImages w treści HTML, jeśli masz obrazy w treści e-maila.
inlineImagesObjectobiekt JavaScript zawierający mapowanie z klucza obrazu (String) na dane obrazu (BlobSource). Zakładamy przy tym, że używany jest parametr htmlBody i zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika),
noReplyBooleantrue, jeśli e-mail powinien zostać wysłany z ogólnego adresu e-mail służącego do wysyłania wiadomości tylko w celu zniechęcenia odbiorców do odpowiadania na e-maile. Ta opcja jest dostępna tylko na kontach Google Workspace, a nie użytkowników Gmaila.
replyToStringadres e-mail, który ma być domyślnym adresem zwrotnym (domyślnie: adres e-mail użytkownika)
subjectStringNowy wiersz tematu e-maila (maksymalnie 250 znaków).

Powroty

GmailMessage – komunikat przydatny przy tworzeniu łańcuszków.

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • 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

Powroty

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

Upoważnienie

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

  • https://mail.google.com/

Zobacz też