Wiadomość na koncie Gmail użytkownika.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createDraftReply(body) | GmailDraft | Tworzy wersję roboczą wiadomości z adresem zwrotnym, odpowiadając nadawcy tej wiadomości. |
createDraftReply(body, options) | GmailDraft | Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego argumentów opcjonalnych. |
createDraftReplyAll(body) | GmailDraft | Tworzy wersję roboczą wiadomości z adresem zwrotnym i wszystkimi adresatami wiadomości, które są wysyłane do nadawcy tę wiadomość. |
createDraftReplyAll(body, options) | GmailDraft | Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami. |
forward(recipient) | GmailMessage | Powoduje przekazanie tej wiadomości do nowych odbiorców. |
forward(recipient, options) | GmailMessage | Powoduje przekazanie tej wiadomości do nowych odbiorców z opcjonalnymi argumentami. |
getAttachments() | GmailAttachment[] | Pobiera wszystkie załączniki do tej wiadomości. |
getAttachments(options) | GmailAttachment[] | Pobiera wszystkie załączniki do tej wiadomości. |
getBcc() | String | Pobiera rozdzielane przecinkami adresatów w polu UDW tej wiadomości. |
getBody() | String | Pobiera treść HTML treści wiadomości. |
getCc() | String | Pobiera rozdzielane przecinkami adresy odbiorców, których kopia została umieszczona w polu DW tej wiadomości. |
getDate() | Date | Pobiera datę i godzinę wysłania tej wiadomości. |
getFrom() | String | Pobiera nadawcę wiadomości. |
getHeader(name) | String | Pobiera wartość nagłówka RFC 2822 na podstawie nazwy nagłówka. |
getId() | String | Pobiera identyfikator wiadomości. |
getPlainBody() | String | Pobiera treść wiadomości bez formatowania HTML. |
getRawContent() | String | Pobiera nieprzetworzoną treść wiadomości. |
getReplyTo() | String | Pobiera adres zwrotny dla tej wiadomości (zwykle jest to adres nadawcy). |
getSubject() | String | Pobiera temat wiadomości. |
getThread() | GmailThread | Pobiera wątek zawierający tę wiadomość. |
getTo() | String | Pobiera rozdzielanych przecinkami adresatów tej wiadomości. |
isDraft() | Boolean | Określa, czy wiadomość jest wersją roboczą. |
isInChats() | Boolean | Określa, czy wiadomość to czat. |
isInInbox() | Boolean | Określa, czy wiadomość znajduje się w skrzynce odbiorczej. |
isInPriorityInbox() | Boolean | Zwraca true , jeśli wiadomość jest w Priorytetach. w przeciwnym razie zwraca false . |
isInTrash() | Boolean | Określa, czy wiadomość znajduje się w koszu. |
isStarred() | Boolean | Określa, czy wiadomość została oznaczona gwiazdką. |
isUnread() | Boolean | Sprawdza, czy wiadomość jest nieprzeczytana. |
markRead() | GmailMessage | Oznacza wiadomość jako przeczytaną. |
markUnread() | GmailMessage | Oznacza wiadomość jako nieprzeczytaną. |
moveToTrash() | GmailMessage | Przenosi wiadomość do kosza. |
refresh() | GmailMessage | Ponownie wczytuje tę wiadomość i powiązany z nią stan z Gmaila (przydatne, gdy etykiety, stan odczytu itp., uległy zmianie). |
reply(body) | GmailMessage | Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego. |
reply(body, options) | GmailMessage | Odpowiada nadawcy tej wiadomości przy użyciu adresu zwrotnego z opcjonalnymi argumentami. |
replyAll(body) | GmailMessage | Odpowiada nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości. |
replyAll(body, options) | GmailMessage | Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, za pomocą: argumentów opcjonalnych. |
star() | GmailMessage | Oznacza wiadomość gwiazdką. |
unstar() | GmailMessage | Usuwa gwiazdkę z wiadomości. |
Szczegółowa dokumentacja
createDraftReply(body)
Tworzy wersję roboczą wiadomości z adresem zwrotnym, odpowiadając nadawcy tej wiadomości. rozmiar e-maila (wraz z nagłówkami) jest ograniczony.
// Create a draft reply to the original message with an acknowledgment. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReply("Got your message");
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
Powrót
GmailDraft
– nowo utworzona wersja robocza wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
createDraftReply(body, options)
Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego argumentów opcjonalnych.
E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (wraz nagłówki) to limit z ograniczeniami.
// Create a draft response with an HTML text body. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReply("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", cc: "another@example.com" });
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | jeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast
wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML
jeśli masz wbudowane obrazy e-maili |
inlineImages | Object | obiekt JavaScript zawierający mapowanie z klucza obrazu
(String ) do danych zdjęcia (BlobSource ); przy założeniu, że używany jest parametr htmlBody , który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to 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 (maksymalnie 250 znaków). |
Powrót
GmailDraft
– nowo utworzona wersja robocza wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
createDraftReplyAll(body)
Tworzy wersję roboczą wiadomości z adresem zwrotnym i wszystkimi adresatami wiadomości, które są wysyłane do nadawcy tę wiadomość. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.
// Create a draft response to all recipients (except those bcc'd) with an acknowledgment. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReplyAll("Got your message");
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
Powrót
GmailDraft
– nowo utworzona wersja robocza wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
createDraftReplyAll(body, options)
Tworzy wersję roboczą wiadomości, odpowiadając nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców z opcjonalnymi argumentami.
E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila (wraz nagłówki) to limit z ograniczeniami.
// Create a draft response to all recipients (except those bcc'd) using an HTML text body. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReplyAll("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", cc: "another@example.com" });
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | jeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast
wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML
jeśli masz wbudowane obrazy e-maili |
inlineImages | Object | obiekt JavaScript zawierający mapowanie z klucza obrazu
(String ) do danych zdjęcia (BlobSource ); przy założeniu, że używany jest parametr htmlBody , który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to 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 (maksymalnie 250 znaków). |
Powrót
GmailDraft
– nowo utworzona wersja robocza wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
forward(recipient)
Powoduje przekazanie tej wiadomości do nowych odbiorców. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony.
// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.forward("recipient1@example.com,recipient2@example.com");
Parametry
Nazwa | Typ | Opis |
---|---|---|
recipient | String | Rozdzielona przecinkami lista adresów e-mail. |
Powrót
GmailMessage
– ten komunikat przydaje się w przypadku tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
forward(recipient, options)
Powoduje przekazanie tej wiadomości do nowych odbiorców z opcjonalnymi argumentami.
E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.
var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.forward("recipient1@example.com,recipient2@example.com", { cc: "myboss@example.com", bcc: "mybosses-boss@example.com,vp@example.com" });
Parametry
Nazwa | Typ | Opis |
---|---|---|
recipient | String | Rozdzielona przecinkami lista adresów e-mail. |
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | jeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast
wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML
jeśli masz wbudowane obrazy e-maili |
inlineImages | Object | obiekt JavaScript zawierający mapowanie z klucza obrazu
(String ) do danych zdjęcia (BlobSource ); przy założeniu, że używany jest parametr htmlBody , który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika); |
noReply | Boolean | true , jeśli e-mail ma być wysłany z ogólnego adresu
adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest
jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila. |
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
– ten komunikat przydaje się w przypadku tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getAttachments()
Pobiera wszystkie załączniki do tej wiadomości.
Powrót
GmailAttachment[]
– tablica z załącznikami obiektów blob dla tej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getAttachments(options)
Pobiera wszystkie załączniki do tej wiadomości.
Parametry
Nazwa | Typ | Opis |
---|---|---|
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
includeInlineImages | Boolean | true , jeśli zwrócona tablica obiektu blob
załączniki powinny zawierać obrazy w tekście (domyślnie true ). |
includeAttachments | Boolean | true , jeśli zwrócona tablica obiektu blob
załączniki powinny zawierać zwykłe (niewbudowane) załączniki (domyślnie true ). |
Powrót
GmailAttachment[]
– tablica z załącznikami obiektów blob dla tej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getBcc()
Pobiera rozdzielane przecinkami adresatów w polu UDW tej wiadomości.
To pole jest puste w przypadku wszystkich odebranych wiadomości (według definicji).
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getBcc()); // Log bcc'd addresses
Powrót
String
– rozdzielane przecinkami adresy odbiorców w polu UDW tej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getBody()
Pobiera treść HTML treści wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getBody()); // Log contents of the body
Powrót
String
– treść wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getCc()
Pobiera rozdzielane przecinkami adresy odbiorców, których kopia została umieszczona w polu DW tej wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getCc()); // Log cc'd addresses
Powrót
String
– rozdzielane przecinkami adresy odbiorców, których adresy DW zostały wysłane do tej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getDate()
Pobiera datę i godzinę wysłania tej wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getDate()); // Log date and time of the message
Powrót
Date
– data i godzina wysłania wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getFrom()
Pobiera nadawcę wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getFrom()); // Log from address of the message
Powrót
String
– adres e-mail nadawcy wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getHeader(name)
Pobiera wartość nagłówka RFC 2822 na podstawie nazwy nagłówka.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox. var message = thread.getMessages()[0]; // Get the first message. Logger.log(message.getHeader("Message-ID")); // Logs the Message-ID RFC 2822 header.
Parametry
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 w wiadomości nie ma nagłówka.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getId()
Pobiera identyfikator wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message var id = message.getId(); var messageById = GmailApp.getMessageById(id); Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true
Powrót
String
– identyfikator wiadomości.
getPlainBody()
Pobiera treść wiadomości bez formatowania HTML. To bardziej skomplikowane niż
getBody()
i zajmuje to dłużej.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getPlainBody()); // Log contents of the body
Powrót
String
– zwykła treść wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getRawContent()
Pobiera nieprzetworzoną treść wiadomości. To odpowiednik opcji „Pokaż oryginał” w interfejsie Gmaila.
Powrót
String
– nieprzetworzona treść wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getReplyTo()
Pobiera adres zwrotny dla tej wiadomości (zwykle jest to adres nadawcy).
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getReplyTo()); // Logs reply-to address
Powrót
String
– adres e-mail do odpowiedzi.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getSubject()
Pobiera temat wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getSubject()); // Log subject line
Powrót
String
– temat wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getThread()
Pobiera wątek zawierający tę wiadomość.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getThread().getFirstMessageSubject() == thread.getFirstMessageSubject()); // Always logs true
Powrót
GmailThread
– wątek GmailThread zawierający tę wiadomość.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getTo()
Pobiera rozdzielanych przecinkami adresatów tej wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getTo()); // Log the recipient of message
Powrót
String
– rozdzielany przecinkami adresaci tej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
isDraft()
Określa, czy wiadomość jest wersją roboczą.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is draft? " + message.isDraft());
Powrót
Boolean
– określa, czy wiadomość jest wersją roboczą.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
isInChats()
Określa, czy wiadomość to czat.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is a chat? " + message.isInChats());
Powrót
Boolean
– określa, czy wiadomość jest czatem.
isInInbox()
Określa, czy wiadomość znajduje się w skrzynce odbiorczej.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is in inbox? " + message.isInInbox());
Powrót
Boolean
– określa, czy wiadomość jest w skrzynce odbiorczej.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
isInPriorityInbox()
Zwraca true
, jeśli wiadomość jest w Priorytetach. w przeciwnym razie zwraca false
.
var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox var messages = thread.getMessages(); for (var i = 0; i < messages.length; i++) { // At least one of the messages is in priority inbox Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox()); }
Powrót
Boolean
– określa, czy wiadomość znajduje się w Priorytetach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
isInTrash()
Określa, czy wiadomość znajduje się w koszu.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is in the trash? " + message.isInTrash());
Powrót
Boolean
– określa, czy wiadomość znajduje się w koszu.
isStarred()
Określa, czy wiadomość została oznaczona gwiazdką.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is starred? " + message.isStarred());
Powrót
Boolean
– określa, czy wiadomość jest oznaczona gwiazdką.
isUnread()
Sprawdza, czy wiadomość jest nieprzeczytana.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is unread? " + message.isUnread());
Powrót
Boolean
– stan nieprzeczytanej wiadomości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
markRead()
Oznacza wiadomość jako przeczytaną.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.markRead(); // Mark as read
Powrót
GmailMessage
– ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
markUnread()
Oznacza wiadomość jako nieprzeczytaną.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.markUnread(); // Mark as unread
Powrót
GmailMessage
– ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
moveToTrash()
Przenosi wiadomość do kosza.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.moveToTrash(); // Move message to trash
Powrót
GmailMessage
– ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
refresh()
Ponownie wczytuje tę wiadomość i powiązany z nią stan z Gmaila (przydatne, gdy etykiety, stan odczytu itp., uległy zmianie).
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message // .. Do bunch of stuff here message.refresh(); // Make sure it's up to date // Do more stuff to message
Powrót
GmailMessage
– komunikat dotyczący tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
reply(body)
Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.
// Respond to author of message with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.reply("Got your message");
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
Powrót
GmailMessage
– ten komunikat przydaje się w przypadku tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
reply(body, options)
Odpowiada nadawcy tej wiadomości przy użyciu adresu zwrotnego z opcjonalnymi argumentami.
E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.
// Respond with HTML body text var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.reply("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", noReply: true });
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | jeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast
wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML
jeśli masz wbudowane obrazy e-maili |
inlineImages | Object | obiekt JavaScript zawierający mapowanie z klucza obrazu
(String ) do danych zdjęcia (BlobSource ); przy założeniu, że używany jest parametr htmlBody , który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika); |
noReply | Boolean | true , jeśli e-mail ma być wysłany z ogólnego adresu
adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest
jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila. |
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
– ten komunikat przydaje się w przypadku tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
replyAll(body)
Odpowiada nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości. Rozmiar wiadomości (w tym nagłówki) są ograniczone.
// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.replyAll("Got your message");
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
Powrót
GmailMessage
– ta wiadomość przydaje się podczas tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
replyAll(body, options)
Odpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, za pomocą: argumentów opcjonalnych.
E-mail może zawierać zarówno zwykły tekst, jak i treść HTML. Rozmiar e-maila. (wraz z nagłówkami) to limit z ograniczeniami.
// Respond with HTML body text var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; messageThread.replyAll("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", noReply: true });
Parametry
Nazwa | Typ | Opis |
---|---|---|
body | String | Treść e-maila. |
options | Object | Obiekt JavaScriptu, który określa zaawansowane parametry wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
attachments | BlobSource[] | tablica plików do wysłania e-mailem |
bcc | String | rozdzielana przecinkami lista adresów e-mail do pola UDW |
cc | String | rozdzielana przecinkami lista adresów e-mail, na które należy wysłać kopie wiadomości |
from | String | adres, z którego ma zostać wysłany e-mail (musi to być jeden z nich)
wartości zwróconych przez funkcję GmailApp.getAliases() |
htmlBody | String | jeśli jest on skonfigurowany, urządzenia, które potrafią renderować kod HTML, będą go używać zamiast
wymagany argument body; można dodać opcjonalne pole inlineImages w treści HTML
jeśli masz wbudowane obrazy e-maili |
inlineImages | Object | obiekt JavaScript zawierający mapowanie z klucza obrazu
(String ) do danych zdjęcia (BlobSource ); przy założeniu, że używany jest parametr htmlBody , który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" /> |
name | String | nazwa nadawcy e-maila (domyślnie jest to nazwa użytkownika); |
noReply | Boolean | true , jeśli e-mail ma być wysłany z ogólnego adresu
adres e-mail używany tylko do wysyłania e-maili, który zniechęca odbiorców do odpowiadania na e-maile; ta opcja jest
jest to możliwe tylko na kontach Google Workspace, nie na kontach użytkowników Gmaila. |
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
– ten komunikat przydaje się w przypadku tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
star()
Oznacza wiadomość gwiazdką.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.star(); // Star the message
Powrót
GmailMessage
– ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
unstar()
Usuwa gwiazdkę z wiadomości.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.unstar(); // Unstar the message
Powrót
GmailMessage
– ta wiadomość GmailMessage przydaje się do tworzenia łańcuszków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/