Class MailApp

MailApp

メールを送信します。

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

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

メソッド

メソッド戻り値の型概要
getRemainingDailyQuota()Integerその日の残りの時間にメールを送信できる受信者の数を返します。
sendEmail(message)voidメール メッセージを送信します。
sendEmail(recipient, subject, body)voidメール メッセージを送信します。
sendEmail(recipient, subject, body, options)void省略可能な引数を使用してメール メッセージを送信します。
sendEmail(to, replyTo, subject, body)voidメール メッセージを送信します。

詳細なドキュメント

getRemainingDailyQuota()

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

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

const 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() {
  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,
    },
  });
}

パラメータ

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

高度なパラメータ

名前タイプ説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC に追加するメールアドレスのカンマ区切りのリスト
bodyStringメールの本文
ccStringCC に追加するメールアドレスのカンマ区切りのリスト
htmlBodyString設定されている場合、HTML をレンダリングできるデバイスは、必須の本文引数の代わりにこれを使用します。メールにインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー（String）から画像データ（BlobSource）へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています（例を参照）。
nameStringメールの送信者の名前。デフォルトは送信者のユーザー名です。
noReplyBoolean受信者がメールに返信しないように、一般的な返信不可のメールアドレスからメールを送信する場合は true。このオプションは Google Workspace アカウントでのみ使用でき、Gmail ユーザーは使用できません。
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.
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],
    },
);

パラメータ

名前タイプ説明
recipientString受信者のアドレス（カンマ区切り）
subjectString件名
bodyStringメールの本文
optionsObject高度なパラメータを指定する JavaScript オブジェクト（以下を参照）

高度なパラメータ

名前タイプ説明
attachmentsBlobSource[]メールで送信するファイルの配列（例を参照）
bccStringBCC に追加するメールアドレスのカンマ区切りのリスト
ccStringCC に追加するメールアドレスのカンマ区切りのリスト
htmlBodyString設定されている場合、HTML をレンダリングできるデバイスは、必須の本文引数の代わりにこれを使用します。メールにインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー（String）から画像データ（BlobSource）へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前（デフォルト: ユーザーの名前）
noReplyBoolean受信者がメールに返信しないように、一般的な返信不可のメールアドレスからメールを送信する場合は true。このオプションは 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