メールを送信します。
このサービスを使用すると、ユーザーはメールのコンテンツを完全に制御してメールを送信できます。GmailApp とは異なり、MailApp の唯一の目的はメールの送信です。MailApp はユーザーの Gmail 受信トレイにアクセスできません。
GmailApp を使用して作成されたスクリプトを変更すると、MailApp スクリプトよりもユーザーからの再承認リクエストが発生する可能性が高くなります。
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
get | Integer | 当日中にメールを送信できる受信者の数を返します。 |
send | void | メール メッセージを送信します。 |
send | void | メール メッセージを送信します。 |
send | void | 省略可能な引数を指定してメール メッセージを送信します。 |
send | void | メール メッセージを送信します。 |
詳細なドキュメント
get Remaining Daily Quota()
残りの日数にメールを送信できる受信者の数を返します。返される値は現在の実行に対して有効であり、実行ごとに異なる場合があります。
割り当てはメール受信者の数に基づいています。具体的な割り当て情報については、Google サービスの割り当てをご覧ください。
const emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);
戻る
Integer
- スクリプトが送信できる残りのメールの数。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.send_mail
send Email(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, }, }); }
パラメータ
名前 | 型 | 説明 |
---|---|---|
message | Object | メール メッセージを表す JavaScript オブジェクト |
拡張パラメータ
名前 | 型 | 説明 |
---|---|---|
attachments | Blob | メールと一緒に送信するファイルの配列 |
bcc | String | BCC に追加するメールアドレスのカンマ区切りのリスト |
body | String | メールの本文 |
cc | String | CC に追加するメールアドレスのカンマ区切りのリスト |
html | String | 設定されている場合、HTML をレンダリングできるデバイスは、必須の body 引数の代わりにこれを使用します。メールに画像をインライン化している場合は、HTML 本文にオプションの inline フィールドを追加できます。 |
inline | Object | 画像キー(String )から画像データ(Blob )へのマッピングを含む JavaScript オブジェクト。これは、html パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています(例を参照)。 |
name | String | メールの送信者の名前。デフォルトは送信者のユーザー名です。 |
no | Boolean | true : 受信者がメールに返信しないように、一般的な返信不可のメールアドレスからメールを送信する場合。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用できます。 |
reply | String | デフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)。no が true に設定されている場合、reply は無視されます。 |
subject | String | メールの件名 |
to | String | 受信者のメールアドレス、または受信者となるメールアドレスのカンマ区切りリスト |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.send_mail
関連情報
send Email(recipient, subject, body)
メール メッセージを送信します。
App .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
send Email(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], }, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
recipient | String | 受信者のアドレス(カンマ区切り) |
subject | String | 件名 |
body | String | メールの本文 |
options | Object | 以下に示すように、高度なパラメータを指定する JavaScript オブジェクト |
拡張パラメータ
名前 | 型 | 説明 |
---|---|---|
attachments | Blob | メールと一緒に送信するファイルの配列(例を参照) |
bcc | String | BCC に追加するメールアドレスのカンマ区切りのリスト |
cc | String | CC に追加するメールアドレスのカンマ区切りのリスト |
html | String | 設定されている場合、HTML をレンダリングできるデバイスは、必須の body 引数の代わりにこれを使用します。メールに画像をインライン化している場合は、HTML 本文にオプションの inline フィールドを追加できます。 |
inline | Object | 画像キー(String )から画像データ(Blob )へのマッピングを含む JavaScript オブジェクト。これは、html パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。 |
name | String | メールの送信者の名前(デフォルト: ユーザーの名前) |
no | Boolean | true : 受信者がメールに返信しないように、一般的な返信不可のメールアドレスからメールを送信する場合。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用できます。 |
reply | String | デフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス) |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.send_mail
関連情報
send Email(to, replyTo, subject, body)
メール メッセージを送信します。この方法では、送信者とは異なる、送信されたメッセージの Reply-To アドレスを簡単に指定できます。
App .sendEmail( 'recipient@example.com', 'replies@example.com', 'TPS report status', 'What is the status of those TPS reports?', );
パラメータ
名前 | 型 | 説明 |
---|---|---|
to | String | 受信者のアドレス(カンマ区切り) |
reply | String | 返信先アドレス |
subject | String | 件名 |
body | String | メールの本文(平文) |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.send_mail