Class MailApp

MailApp

メールを送信します。

このサービスを利用すると、ユーザーはメールの内容を完全に管理しながらメールを送信できます。 GmailApp とは異なり、MailApp の唯一の目的はメールの送信です。MailApp がユーザーの Gmail にアクセスできません 受信トレイに残ります。

GmailApp を使用して記述したスクリプトを変更すると、再認証がトリガーされる可能性が高くなります。 実行を許可するかどうかを選択できます

メソッド

メソッド戻り値の型概要
getRemainingDailyQuota()Integerその日の残りの時間帯にメールを送信できる宛先の数を返します。
sendEmail(message)voidメール メッセージを送信します。
sendEmail(recipient, subject, body)voidメール メッセージを送信します。
sendEmail(recipient, subject, body, options)voidオプションの引数を指定してメール メッセージを送信します。
sendEmail(to, replyTo, subject, body)voidメール メッセージを送信します。

詳細なドキュメント

getRemainingDailyQuota()

その日にメールを送信できる宛先の数を返します。返される の値は現在の実行では有効であり、実行によって異なる場合があります。

割り当ては、メール受信者の数に基づきます。具体的な割り当て情報については、Google Cloud の割り当て サービス

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

戻る

Integer - スクリプトが送信できる残りのメールの件数。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

sendEmail(message)

メール メッセージを送信します。このバリエーションのメソッドは柔軟性に優れており、 その他のオプションです

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png";
  var youtubeLogoUrl =
        "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png";
  var googleLogoBlob = UrlFetchApp
                         .fetch(googleLogoUrl)
                         .getBlob()
                         .setName("googleLogoBlob");
  var 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
      }
  });
}

パラメータ

名前説明
messageObjectメール メッセージを表す JavaScript オブジェクト

拡張パラメータ

名前説明
attachmentsBlobSource[] メールで送信するファイルの配列
bccStringBcc に送信するメールアドレスのカンマ区切りのリスト
bodyStringメールの本文
ccStringCc に追加するメールアドレスのカンマ区切りのリスト
htmlBodyString設定すると、HTML をレンダリングできるデバイスで代わりに使用されます。 あります。HTML でオプションの inlineImages フィールドを追加できます。 本文にインライン画像がある場合は
inlineImagesObjectイメージキーからのマッピングを含む JavaScript オブジェクト (String)から画像データ(BlobSource)へ。これは、htmlBody パラメータが使用され、<img src="cid:imageKey" /> 形式でこれらの画像への参照が含まれていることを前提としています(例を参照)。
nameStringメールの送信者の名前。デフォルトでは送信者の 表示されます。
noReplyBooleantrue: メールを一般的な送信元から送信する場合は、 受信者がメールに返信しないように、返信なしの E メール・アドレスを使用する。このオプションは Google Workspace アカウントでのみ可能で、Gmail ユーザーは対象外
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス (デフォルト: ユーザーのメールアドレス)。noReplytrue に設定されている場合、replyTo は無視されます。
subjectStringメールの件名
toString受信者のメールアドレス、または受信者のメールアドレスのカンマ区切りのリストが メールアドレスを入力します

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

関連情報


sendEmail(recipient, subject, body)

メール メッセージを送信します。

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

パラメータ

名前説明
recipientString受信者のアドレス(カンマで区切る)
subjectString件名
bodyStringメールの本文

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

sendEmail(recipient, subject, body, options)

オプションの引数を指定してメール メッセージを送信します。

// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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]
});

パラメータ

名前説明
recipientString受信者のアドレス(カンマで区切る)
subjectString件名
bodyStringメールの本文
optionsObject詳細パラメータを指定する JavaScript オブジェクト(下記を参照)

拡張パラメータ

名前説明
attachmentsBlobSource[] メールと一緒に送信するファイルの配列(例を参照)
bccStringBcc に送信するメールアドレスのカンマ区切りのリスト
ccStringCc に追加するメールアドレスのカンマ区切りのリスト
htmlBodyString設定すると、HTML をレンダリングできるデバイスで代わりに使用されます。 あります。HTML でオプションの inlineImages フィールドを追加できます。 本文にインライン画像がある場合は
inlineImagesObjectイメージキーからのマッピングを含む JavaScript オブジェクト (String)から画像データ(BlobSource)へ。htmlBody パラメータが使用され、<img src="cid:imageKey" /> 形式でこれらの画像への参照が含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザー名)
noReplyBooleantrue: メールを一般的な送信元から送信する場合は、 受信者がメールに返信しないように、返信なしの E メール・アドレスを使用する。このオプションは Google Workspace アカウントでのみ可能で、Gmail ユーザーは対象外
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス (デフォルト: ユーザーのメールアドレス)。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

関連情報


sendEmail(to, replyTo, subject, body)

メール メッセージを送信します。この方法を使用すると、ユーザーはメッセージの返信先アドレスを 送信元とは異なる場合があります。

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

パラメータ

名前説明
toString受信者のアドレス(カンマで区切る)
replyToString返信先アドレス
subjectString件名
bodyString書式なしテキスト形式のメールの本文です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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