Mengirim email.
Layanan ini memungkinkan pengguna mengirim email dengan kontrol penuh atas konten email. Tidak seperti GmailApp, tujuan MailApp hanya mengirim email. MailApp tidak dapat mengakses Gmail pengguna kotak masuk.
Perubahan pada skrip yang ditulis menggunakan GmailApp kemungkinan besar memicu otorisasi ulang permintaan dari pengguna daripada skrip MailApp.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getRemainingDailyQuota() | Integer | Menampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari itu. |
sendEmail(message) | void | Mengirim pesan email. |
sendEmail(recipient, subject, body) | void | Mengirim pesan email. |
sendEmail(recipient, subject, body, options) | void | Mengirim pesan email dengan argumen opsional. |
sendEmail(to, replyTo, subject, body) | void | Mengirim pesan email. |
Dokumentasi mendetail
getRemainingDailyQuota()
Menampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari itu. URL yang dikembalikan valid untuk eksekusi saat ini dan mungkin bervariasi antareksekusi.
Kuota didasarkan pada jumlah penerima email. Untuk mengetahui informasi kuota tertentu, lihat Kuota untuk Google Layanan.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
Pulang pergi
Integer
— Jumlah email tersisa yang dapat dikirim skrip.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
Mengirim pesan email. Variasi metode ini jauh lebih fleksibel, memungkinkan banyak opsi lainnya.
// 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: "[email protected]", subject: "Logos", htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" + "inline YouTube Logo <img src='cid:youtubeLogo'>", inlineImages: { googleLogo: googleLogoBlob, youtubeLogo: youtubeLogoBlob } }); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
message | Object | objek JavaScript yang mewakili pesan email |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
attachments | BlobSource[] | sebuah rangkaian file untuk dikirim melalui email |
bcc | String | daftar alamat email yang dipisahkan koma ke BCC |
body | String | isi email |
cc | String | daftar alamat email yang dipisahkan koma ke CC |
htmlBody | String | jika disetel, perangkat yang dapat merender HTML akan menggunakannya
argumen body yang dibutuhkan; Anda dapat menambahkan kolom inlineImages opsional di HTML
body jika Anda memiliki gambar sisipan untuk email |
inlineImages | Object | objek JavaScript yang berisi pemetaan dari kunci gambar
(String ) ke data gambar (BlobSource ); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" /> (lihat contoh) |
name | String | nama pengirim email. Setelan defaultnya adalah nama pengguna. |
noReply | Boolean | true jika email harus dikirim dari email
alamat email yang tidak dibalas untuk mencegah penerima membalas email; opsi ini
hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail |
replyTo | String | alamat email untuk digunakan sebagai alamat balas-ke default
(default: alamat email pengguna). Jika noReply ditetapkan ke true , replyTo akan diabaikan. |
subject | String | subjek email |
to | String | alamat email penerima atau daftar yang dipisahkan koma dari alamat email Anda sebagai penerima |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail
Lihat juga
sendEmail(recipient, subject, body)
Mengirim pesan email.
MailApp.sendEmail("[email protected]", "TPS reports", "Where are the TPS reports?");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
recipient | String | alamat penerima, dipisahkan dengan koma |
subject | String | baris subjek |
body | String | isi email |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
Mengirim pesan email dengan argumen opsional.
// 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('[email protected]', 'Attachment example', 'Two files are attached.', { name: 'Automatic Emailer Script', attachments: [file.getAs(MimeType.PDF), blob] });
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
recipient | String | alamat penerima, dipisahkan dengan koma |
subject | String | baris subjek |
body | String | isi email |
options | Object | objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
attachments | BlobSource[] | sebuah array file yang akan dikirim dengan email (lihat contoh) |
bcc | String | daftar alamat email yang dipisahkan koma ke BCC |
cc | String | daftar alamat email yang dipisahkan koma ke CC |
htmlBody | String | jika disetel, perangkat yang dapat merender HTML akan menggunakannya
argumen body yang dibutuhkan; Anda dapat menambahkan kolom inlineImages opsional di HTML
body jika Anda memiliki gambar sisipan untuk email |
inlineImages | Object | objek JavaScript yang berisi pemetaan dari kunci gambar
(String ) ke data gambar (BlobSource ); hal ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" /> |
name | String | nama pengirim email (default: nama pengguna) |
noReply | Boolean | true jika email harus dikirim dari email
alamat email yang tidak dibalas untuk mencegah penerima membalas email; opsi ini
hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail |
replyTo | String | alamat email untuk digunakan sebagai alamat balas-ke default (default: alamat email pengguna) |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail
Lihat juga
sendEmail(to, replyTo, subject, body)
Mengirim pesan email. Metode ini memungkinkan pengguna untuk menentukan alamat Balas-Ke dengan mudah untuk pesan yang dikirim yang dapat berbeda dengan pengirim.
MailApp.sendEmail("[email protected]", "[email protected]", "TPS report status", "What is the status of those TPS reports?");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
to | String | alamat penerima, dipisahkan dengan koma |
replyTo | String | alamat balas-ke |
subject | String | baris subjek |
body | String | isi email dalam bentuk teks polos, |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail