Class GmailMessage

GmailMessage

Wiadomość na koncie Gmail użytkownika.

Metody

MetodaZwracany typKrótki opis
createDraftReply(body)GmailDraftTworzy wersję roboczą wiadomości z odpowiedzią do nadawcy tej wiadomości, używając adresu zwrotnego.
createDraftReply(body, options)GmailDraftTworzy wersję roboczą wiadomości z odpowiedzią do nadawcy tej wiadomości, używając adresu zwrotnego, z argumentami opcjonalnymi.
createDraftReplyAll(body)GmailDraftTworzy wersję roboczą wiadomości z odpowiedzią do nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości.
createDraftReplyAll(body, options)GmailDraftTworzy wersję roboczą wiadomości z odpowiedzią do nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, z argumentami opcjonalnymi.
forward(recipient)GmailMessagePrzekazuje tę wiadomość do nowych odbiorców.
forward(recipient, options)GmailMessagePrzekazuje tę wiadomość do nowych odbiorców z argumentami opcjonalnymi.
getAttachments()GmailAttachment[]Pobiera wszystkie załączniki do tej wiadomości.
getAttachments(options)GmailAttachment[]Pobiera wszystkie załączniki do tej wiadomości.
getBcc()StringPobiera adresy odbiorców, którzy są w polu UDW tej wiadomości, rozdzielone przecinkami.
getBody()StringPobiera zawartość HTML treści tej wiadomości.
getCc()StringPobiera adresy odbiorców w polu DW tej wiadomości rozdzielone przecinkami.
getDate()DatePobiera datę i godzinę tej wiadomości.
getFrom()StringPobiera nadawcę tej wiadomości.
getHeader(name)StringPobiera wartość nagłówka RFC 2822 na podstawie nazwy nagłówka.
getId()StringPobiera identyfikator tej wiadomości.
getPlainBody()StringPobiera treść 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()BooleanOkreśla, czy ta wiadomość jest wersją roboczą.
isInChats()BooleanOkreśla, czy ta wiadomość jest czatem.
isInInbox()BooleanSprawdza, czy ta wiadomość znajduje się w skrzynce odbiorczej.
isInPriorityInbox()BooleanZwraca true, jeśli ta wiadomość znajduje się w skrzynce priorytetowej, a w przeciwnym razie zwraca false.
isInTrash()BooleanOkreśla, czy wiadomość znajduje się w koszu.
isStarred()BooleanOkreśla, czy wiadomość jest oznaczona gwiazdką.
isUnread()BooleanSprawdza, czy wiadomość jest nieprzeczytana.
markRead()GmailMessageOznacza wiadomość jako przeczytaną.
markUnread()GmailMessageOznacza wiadomość jako nieprzeczytaną.
moveToTrash()GmailMessagePrzenosi wiadomość do kosza.
refresh()GmailMessagePonownie wczytuje tę wiadomość i powiązany z nią stan z Gmaila (przydatne, jeśli zmieniły się etykiety, stan odczytu itp.).
reply(body)GmailMessageOdpowiedzi do nadawcy tej wiadomości są wysyłane na adres zwrotny.
reply(body, options)GmailMessageOdpowiada nadawcy tej wiadomości, używając adresu zwrotnego, z opcjonalnymi argumentami.
replyAll(body)GmailMessageOdpowiadanie nadawcy za pomocą adresu zwrotnego i wszystkim odbiorcom tej wiadomości.
replyAll(body, options)GmailMessageOdpowiada nadawcy tej wiadomości, używając adresu zwrotnego i wszystkich odbiorców, z argumentami opcjonalnymi.
star()GmailMessageoznacza wiadomość gwiazdką,
unstar()GmailMessageUsuwa oznaczenie wiadomości gwiazdką.

Szczegółowa dokumentacja

createDraftReply(body)

Tworzy wersję roboczą wiadomości z odpowiedzią do nadawcy tej wiadomości, używając adresu zwrotnego. Rozmiar e-maila (wraz z nagłówkami) jest ograniczony limitem.

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

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


createDraftReply(body, options)

Tworzy wersję roboczą wiadomości z odpowiedzią do nadawcy tej wiadomości, używając adresu zwrotnego, z argumentami opcjonalnymi.

E-mail może zawierać zarówno zwykły tekst, jak i treść w formacie HTML. Rozmiar e-maila (wraz z nagłówkami) przekracza 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: 'another@example.com',
});

Parametry

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

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielona przecinkami;
ccStringlista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
fromStringadres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBodyStringjeśli jest ustawiony, urządzenia obsługujące HTML używają go zamiast wymaganego argumentu body; jeśli masz obrazy wstawione w treść e-maila, możesz dodać opcjonalne pole inlineImages w treści HTML
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subjectStringNowy wiersz tematu e-maila (maks. 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body)

Tworzy wersję roboczą wiadomości z odpowiedzią do nadawcy, używając adresu zwrotnego i wszystkich odbiorców tej wiadomości. Rozmiar e-maila (wraz z nagłówkami) przekracza limit.

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

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


createDraftReplyAll(body, options)

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

E-mail może zawierać zarówno zwykły tekst, jak i treść w formacie HTML. Rozmiar e-maila (wraz z nagłówkami) przekracza 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: 'another@example.com',
});

Parametry

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

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielona przecinkami;
ccStringlista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
fromStringadres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBodyStringjeśli jest ustawiony, urządzenia obsługujące HTML używają go zamiast wymaganego argumentu body; jeśli masz obrazy wstawione w treść e-maila, możesz dodać opcjonalne pole inlineImages w treści HTML
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika);
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subjectStringNowy wiersz tematu e-maila (maks. 250 znaków).

Powrót

GmailDraft – nowo utworzona wersja robocza wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


forward(recipient)

Przekazuje tę wiadomość do nowych odbiorców. Rozmiar e-maila (wraz z nagłówkami) przekracza limit.

// 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('recipient1@example.com,recipient2@example.com');

Parametry

NazwaTypOpis
recipientStringLista adresów e-mail rozdzielona przecinkami.

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


forward(recipient, options)

Przekazuje tę wiadomość do nowych odbiorców z argumentami opcjonalnymi.

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

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

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielona przecinkami;
ccStringlista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
fromStringadres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBodyStringjeśli jest ustawiony, urządzenia obsługujące HTML używają go zamiast wymaganego argumentu body; jeśli masz obrazy wstawione w treść e-maila, możesz dodać opcjonalne pole inlineImages w treści HTML
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika);
noReplyBooleantrue czy e-mail powinien być wysyłany z ogólnego adresu e-mail, na który nie można odpowiadać, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest dostępna tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila;
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subjectStringNowy wiersz tematu e-maila (maks. 250 znaków).

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów 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 załączników Blob do tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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

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

Parametry zaawansowane

NazwaTypOpis
includeInlineImagesBooleantrue, jeśli zwrócona tablica załączników Blob ma zawierać obrazy wstawione w treść (domyślnie true).
includeAttachmentsBooleantrue czy zwrócona tablica załączników Blob powinna zawierać zwykłe (nieinline) załączniki (domyślnie true).

Powrót

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

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

getBcc()

Pobiera adresy odbiorców, którzy są w polu UDW tej wiadomości, rozdzielone przecinkami.

W przypadku wszystkich odebranych wiadomości jest on z definicji pusty.

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 – adresaci w polu UDW, rozdzielani przecinkami.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getBody()

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

Powrót

String – treść tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getCc()

Pobiera adresy odbiorców w polu DW tej wiadomości rozdzielone 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 – adresaci w polu DW, rozdzielani przecinkami.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getDate()

Pobiera datę i godzinę 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.getDate());  // Log date and time of the message

Powrót

Date – data i godzina tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

getFrom()

Pobiera 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

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów 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.

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

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

Powrót

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

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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ść wiadomości bez formatowania HTML. Jest to bardziej skomplikowane niż getBody() i trwa dłużej.

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

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getRawContent()

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

Powrót

String – surowa treść tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 odpowiedzi.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getSubject()

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

Powrót

String – temat tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


getThread()

Pobiera wątek zawierający 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 GmailThread, który zawiera tę wiadomość.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

getTo()

Pobiera 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 – adresaci tej wiadomości rozdzielani przecinkami.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


isDraft()

Określa, czy ta 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 – czy ta wiadomość jest wersją roboczą.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

isInChats()

Określa, czy ta 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 ta wiadomość jest czatem.


isInInbox()

Sprawdza, czy ta 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

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

isInPriorityInbox()

Zwraca true, jeśli ta wiadomość znajduje się w skrzynce priorytetowej, a w przeciwnym razie zwraca 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 wiadomość znajduje się w skrzynce priorytetowej.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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ść jest 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 wiadomość jest oznaczona gwiazdką.


isUnread()

Sprawdza, 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 nieprzeczytania tej wiadomości.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 – ten obiekt GmailMessage, przydatny do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


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 – ten obiekt GmailMessage, przydatny do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


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 – ten obiekt GmailMessage, przydatny do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów 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, jeśli zmieniły się etykiety, stan odczytu 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ść służy do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

reply(body)

Odpowiedzi do nadawcy tej wiadomości są wysyłane na adres zwrotny. Rozmiar e-maila (wraz z nagłówkami) przekracza 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

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


reply(body, options)

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ść w formacie HTML. Rozmiar e-maila (wraz z nagłówkami) przekracza 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

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

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielona przecinkami;
ccStringlista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
fromStringadres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBodyStringjeśli jest ustawiony, urządzenia obsługujące HTML używają go zamiast wymaganego argumentu body; jeśli masz obrazy wstawione w treść e-maila, możesz dodać opcjonalne pole inlineImages w treści HTML
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika);
noReplyBooleantrue czy e-mail powinien być wysyłany z ogólnego adresu e-mail, na który nie można odpowiadać, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest dostępna tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila;
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subjectStringNowy wiersz tematu e-maila (maks. 250 znaków).

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


replyAll(body)

Odpowiadanie nadawcy za pomocą adresu zwrotnego i wszystkim odbiorcom tej wiadomości. Rozmiar e-maila (wraz z nagłówkami) przekracza limit.

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

NazwaTypOpis
bodyStringTreść e-maila.

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów 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, z argumentami opcjonalnymi.

E-mail może zawierać zarówno zwykły tekst, jak i treść w formacie HTML. Rozmiar e-maila (wraz z nagłówkami) przekracza 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

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

Parametry zaawansowane

NazwaTypOpis
attachmentsBlobSource[]tablicę plików do wysłania z e-mailem.
bccStringlista adresów e-mail do pola UDW rozdzielona przecinkami;
ccStringlista adresów e-mail, na które należy wysłać kopię wiadomości, rozdzielona przecinkami;
fromStringadres, z którego ma zostać wysłany e-mail. Musi to być jedna z wartości zwróconych przez GmailApp.getAliases().
htmlBodyStringjeśli jest ustawiony, urządzenia obsługujące HTML używają go zamiast wymaganego argumentu body; jeśli masz obrazy wstawione w treść e-maila, możesz dodać opcjonalne pole inlineImages w treści HTML
inlineImagesObjectobiekt JavaScript zawierający mapowanie klucza obrazu (String) na dane obrazu (BlobSource); zakłada się, że używany jest parametr htmlBody, który zawiera odwołania do tych obrazów w formacie <img src="cid:imageKey" />.
nameStringnazwa nadawcy e-maila (domyślnie: nazwa użytkownika);
noReplyBooleantrue czy e-mail powinien być wysyłany z ogólnego adresu e-mail, na który nie można odpowiadać, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest dostępna tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila;
replyToStringadres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie: adres e-mail użytkownika);
subjectStringNowy wiersz tematu e-maila (maks. 250 znaków).

Powrót

GmailMessage – ta wiadomość jest przydatna do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


star()

oznacza 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 – ten obiekt GmailMessage, przydatny do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też


unstar()

Usuwa oznaczenie wiadomości gwiazdką.

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 – ten obiekt GmailMessage, przydatny do łączenia.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

  • https://mail.google.com/

Zobacz też