Ta strona została przetłumaczona przez Cloud Translation API.

Class MailApp

wysyła e-maile,

Ta usługa umożliwia użytkownikom wysyłanie e-maili z pełną kontrolą nad ich treścią. W przeciwieństwie do GmailApp jedynym celem MailApp jest wysyłanie e-maili. MailApp nie może uzyskać dostępu do skrzynki odbiorczej Gmaila użytkownika.

Zmiany w skryptach napisanych za pomocą GmailApp częściej powodują prośbę o ponowne udzielenie autoryzacji przez użytkownika niż skrypty MailApp.

Metody

Metoda	Zwracany typ	Krótki opis
`getRemainingDailyQuota()`	`Integer`	Zwraca liczbę adresatów, do których możesz wysyłać e-maile do końca dnia.
`sendEmail(message)`	`void`	wysyła e-maile;
`sendEmail(recipient, subject, body)`	`void`	wysyła e-maile;
`sendEmail(recipient, subject, body, options)`	`void`	Wysyła wiadomość e-mail z opcjonalnymi argumentami.
`sendEmail(to, replyTo, subject, body)`	`void`	wysyła e-maile;

Szczegółowa dokumentacja

`getRemainingDailyQuota()`

Zwraca liczbę adresatów, do których możesz wysyłać e-maile do końca dnia. Zwrócona wartość jest ważna dla bieżącego wykonania i może się różnić w zależności od wykonania.

Limity są ustalane na podstawie liczby odbiorców e-maili. Szczegółowe informacje o limitach znajdziesz w artykule Limity usług Google.

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

Powrót

Integer – liczba pozostałych e-maili, które skrypt może wysłać.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.send_mail

`sendEmail(message)`

wysyła e-maile; Ta odmiana metody jest znacznie bardziej elastyczna i zawiera więcej opcji.

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const youtubeLogoBlob =
      UrlFetchApp.fetch(youtubeLogoUrl).getBlob().setName('youtubeLogoBlob');
  MailApp.sendEmail({
    to: 'recipient@example.com',
    subject: 'Logos',
    htmlBody: 'inline Google Logo<img src=\'cid:googleLogo\'> images! <br>' +
        'inline YouTube Logo <img src=\'cid:youtubeLogo\'>',
    inlineImages: {
      googleLogo: googleLogoBlob,
      youtubeLogo: youtubeLogoBlob,
    },
  });
}

Parametry

Nazwa	Typ	Opis
`message`	`Object`	obiekt JavaScriptu reprezentujący wiadomość e-mail;

Parametry zaawansowane

Nazwa	Typ	Opis
`attachments`	`BlobSource[]`	tablica plików do wysłania z e-mailem.
`bcc`	`String`	lista adresów e-mail do pola UDW rozdzielane przecinkami.
`body`	`String`	treść e-maila.
`cc`	`String`	listę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami.
`htmlBody`	`String`	jeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole `inlineImages` w treści HTML, jeśli masz wstawione obrazy w e-mailu
`inlineImages`	`Object`	obiekt JavaScript zawierający mapowanie klucza obrazu (`String`) na dane obrazu (`BlobSource`); zakłada się, że używany jest parametr `htmlBody` i zawiera on odwołania do tych obrazów w formacie `<img src="cid:imageKey" />` (patrz przykład)
`name`	`String`	imię i nazwisko nadawcy e-maila. Domyślnie jest to nazwa użytkownika nadawcy.
`noReply`	`Boolean`	`true` czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
`replyTo`	`String`	adres e-mail, który ma być używany jako domyślny adres, na który mają być wysyłane odpowiedzi (domyślnie: adres e-mail użytkownika). Jeśli `noReply` ma wartość `true`, `replyTo` jest ignorowany.
`subject`	`String`	temat e-maila,
`to`	`String`	adres e-mail adresata lub lista adresów e-mail rozdzielonych przecinkami, które mają być adresowane do adresatów;

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.send_mail

Zobacz też

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

wysyła e-maile;

MailApp.sendEmail(
    'recipient@example.com',
    'TPS reports',
    'Where are the TPS reports?',
);

Parametry

Nazwa	Typ	Opis
`recipient`	`String`	adresy adresatów, rozdzielone przecinkami.
`subject`	`String`	wiersz tematu.
`body`	`String`	treść e-maila.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.send_mail

`sendEmail(recipient, subject, body, options)`

Wysyła wiadomość e-mail z opcjonalnymi argumentami.

// Send an email with two attachments: a file from Google Drive (as a PDF) and
// an HTML file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const blob = Utilities.newBlob(
    'Insert any HTML content here',
    'text/html',
    'my_document.html',
);
MailApp.sendEmail(
    'mike@example.com',
    'Attachment example',
    'Two files are attached.',
    {
      name: 'Automatic Emailer Script',
      attachments: [file.getAs(MimeType.PDF), blob],
    },
);

Parametry

Nazwa	Typ	Opis
`recipient`	`String`	adresy adresatów, rozdzielone przecinkami.
`subject`	`String`	wiersz tematu.
`body`	`String`	treść e-maila.
`options`	`Object`	obiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
`attachments`	`BlobSource[]`	tablicę plików do wysłania z e-mailem (patrz przykład)
`bcc`	`String`	lista adresów e-mail do pola UDW rozdzielane przecinkami.
`cc`	`String`	listę adresów e-mail do umieszczenia w polu DW, rozdzielonych przecinkami.
`htmlBody`	`String`	jeśli jest ustawiony, urządzenia, które mogą renderować HTML, będą używać go zamiast wymaganego argumentu body; możesz dodać opcjonalne pole `inlineImages` w treści HTML, jeśli masz wstawione obrazy w e-mailu
`inlineImages`	`Object`	obiekt JavaScript zawierający mapowanie klucza obrazu (`String`) na dane obrazu (`BlobSource`); zakłada się, że używany jest parametr `htmlBody` i zawiera on odwołania do tych obrazów w formacie `<img src="cid:imageKey" />`
`name`	`String`	nazwa nadawcy e-maila (domyślnie imię i nazwisko użytkownika);
`noReply`	`Boolean`	`true` czy e-mail ma być wysyłany z ogólnego adresu e-mail bez możliwości odpowiedzi, aby zniechęcić odbiorców do odpowiadania na e-maile; ta opcja jest możliwa tylko w przypadku kont Google Workspace, a nie użytkowników Gmaila
`replyTo`	`String`	adres e-mail, który ma być używany jako domyślny adres zwrotny (domyślnie adres e-mail użytkownika);

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.send_mail

Zobacz też

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

wysyła e-maile; Ta metoda umożliwia użytkownikowi łatwe określenie adresu Odpowiedź-do dla wysłanej wiadomości, który może różnić się od adresu nadawcy.

MailApp.sendEmail(
    'recipient@example.com',
    'replies@example.com',
    'TPS report status',
    'What is the status of those TPS reports?',
);

Parametry

Nazwa	Typ	Opis
`to`	`String`	adresy adresatów, rozdzielone przecinkami.
`replyTo`	`String`	adres zwrotny.
`subject`	`String`	wiersz tematu.
`body`	`String`	treść e-maila w postaci zwykłego tekstu.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/script.send_mail