メールを送信します。
このサービスを使用すると、ユーザーはメールを送信する際に、メールの内容を完全に制御できます。 GmailApp とは異なり、MailApp はメールの送信のみを目的としています。MailApp がユーザーの Gmail 受信トレイにアクセスできません。
GmailApp を使用して記述されたスクリプトに変更を加えると、MailApp スクリプトよりも、ユーザーからの再認証リクエストがトリガーされる可能性が高くなります。
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
getRemainingDailyQuota() | Integer | その日の残りの期間、メールを送信できる宛先の数を返します。 |
sendEmail(message) | void | メール メッセージを送信します。 |
sendEmail(recipient, subject, body) | void | メール メッセージを送信します。 |
sendEmail(recipient, subject, body, options) | void | オプションの引数を指定してメール メッセージを送信します。 |
sendEmail(to, replyTo, subject, body) | void | メール メッセージを送信します。 |
詳細なドキュメント
getRemainingDailyQuota()
その日の残りの期間、メールを送信できる宛先の数を返します。戻り値は現在の実行に対して有効であり、実行によって異なる場合があります。
割り当てはメールの受信者の数に基づいて決まります。具体的な割り当て情報については、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 } }); }
パラメータ
名前 | 型 | 説明 |
---|---|---|
message | Object | メール メッセージを表す JavaScript オブジェクト |
拡張パラメータ
名前 | 型 | 説明 |
---|---|---|
attachments | BlobSource[] | メールと一緒に送信するファイルの配列 |
bcc | String | Bcc で送信するメールアドレスのカンマ区切りのリスト |
body | String | メールの本文 |
cc | String | Cc に含めるメールアドレスのカンマ区切りのリスト |
htmlBody | String | 設定すると、HTML をレンダリングできるデバイスは、必須の本文引数の代わりにそれを使用します。メール用にインライン画像を用意する場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。 |
inlineImages | Object | 画像キー(String )から画像データ(BlobSource )へのマッピングを含む JavaScript オブジェクト。htmlBody パラメータが使用され、<img src="cid:imageKey" /> 形式でこれらの画像への参照が格納されていることを前提としています(例を参照)。 |
name | String | メールの送信者名。デフォルトは送信者のユーザー名です。 |
noReply | Boolean | true : 受信者がメールに返信しないよう、一般的な返信不可のメールアドレスからメールを送信する必要がある場合。このオプションは Google Workspace アカウントでのみ使用できます。Gmail ユーザーでは使用できません。 |
replyTo | String | デフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)。noReply が true に設定されている場合、replyTo は無視されます。 |
subject | String | メールの件名 |
to | String | 受信者のメールアドレス、または受信者のメールアドレスのカンマ区切りのリスト |
承認
この方法を使用するスクリプトには、次の 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?");
パラメータ
名前 | 型 | 説明 |
---|---|---|
recipient | String | 受信者のアドレスをカンマで区切って |
subject | String | 件名 |
body | String | メールの本文 |
承認
この方法を使用するスクリプトには、次の 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] });
パラメータ
名前 | 型 | 説明 |
---|---|---|
recipient | String | 受信者のアドレスをカンマで区切って |
subject | String | 件名 |
body | String | メールの本文 |
options | Object | 詳細パラメータを指定する JavaScript オブジェクト(下記を参照) |
拡張パラメータ
名前 | 型 | 説明 |
---|---|---|
attachments | BlobSource[] | メールとともに送信するファイルの配列(例を参照) |
bcc | String | Bcc で送信するメールアドレスのカンマ区切りのリスト |
cc | String | Cc に含めるメールアドレスのカンマ区切りのリスト |
htmlBody | String | 設定すると、HTML をレンダリングできるデバイスは、必須の本文引数の代わりにそれを使用します。メール用にインライン画像を用意する場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。 |
inlineImages | Object | 画像キー(String )から画像データ(BlobSource )へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、<img src="cid:imageKey" /> 形式でこれらの画像への参照が含まれていることを前提としています。 |
name | String | メールの送信者の名前(デフォルト: ユーザー名) |
noReply | Boolean | true : 受信者がメールに返信しないよう、一般的な返信不可のメールアドレスからメールを送信する必要がある場合。このオプションは Google Workspace アカウントでのみ使用できます。Gmail ユーザーでは使用できません。 |
replyTo | String | デフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス) |
承認
この方法を使用するスクリプトには、次の 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?");
パラメータ
名前 | 型 | 説明 |
---|---|---|
to | String | 受信者のアドレスをカンマで区切って |
replyTo | String | 返信先アドレス |
subject | String | 件名 |
body | String | 書式なしテキストでメールの本文を |
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.send_mail