Class MailApp

MailApp

メールを送信します。

このサービスを使用すると、ユーザーはメールのコンテンツを完全に制御しながらメールを送信できます。GmailApp とは異なり、MailApp はメールの送信のみを目的としています。MailApp はユーザーの Gmail 受信トレイにアクセスできません。

GmailApp を使用して記述されたスクリプトに対する変更は、MailApp スクリプトよりもユーザーからの再承認リクエストをトリガーする可能性が高くなります。

Methods

方法戻り値の型概要
getRemainingDailyQuota()Integer1 日の残りの時間のメールの送信先となる受信者の数を返します。
sendEmail(message)voidメールを送信します。
sendEmail(recipient, subject, body)voidメールを送信します。
sendEmail(recipient, subject, body, options)void省略可能な引数でメール メッセージを送信します。
sendEmail(to, replyTo, subject, body)voidメールを送信します。

詳細なドキュメント

getRemainingDailyQuota()

1 日の残りの時間のメールの送信先となる受信者の数を返します。戻り値は現在の実行に対して有効であり、実行ごとに異なる可能性があります。

割り当てはメールの受信者の数に基づきます。特定の割り当て情報については、Google サービスの割り当てをご覧ください。

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 をレンダリングします。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー（String）から画像データ（BlobSource）へのマッピングを含む JavaScript オブジェクト。htmlBody パラメータが使用されており、<img src="cid:imageKey" /> という形式でこれらの画像への参照が含まれていることを前提としています。
nameStringメールの送信者の名前。デフォルトは送信者のユーザー名です。
noReplyBooleantrue: 受信者がメールに返信しないように、返信しない汎用的なメールアドレスからメールを送信する場合に必要です。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用可能です。
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス（デフォルト: ユーザーのメールアドレス）。noReply が true に設定されている場合、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 をレンダリングします。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー（String）から画像データ（BlobSource）へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前（デフォルト: ユーザーの名前）
noReplyBooleantrue: 受信者がメールに返信しないように、返信しない汎用的なメールアドレスからメールを送信する場合に必要です。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用可能です。
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