Mengirim email.
Layanan ini memungkinkan pengguna mengirim email dengan kontrol penuh atas konten email. Tidak seperti GmailApp, tujuan MailApp adalah mengirim email. MailApp tidak dapat mengakses kotak masuk Gmail pengguna.
Perubahan pada skrip yang ditulis menggunakan GmailApp lebih cenderung memicu permintaan otorisasi ulang dari pengguna daripada skrip MailApp.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
get | Integer | Menampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari ini. |
send | void | Mengirim pesan email. |
send | void | Mengirim pesan email. |
send | void | Mengirim pesan email dengan argumen opsional. |
send | void | Mengirim pesan email. |
Dokumentasi mendetail
get Remaining Daily Quota()
Menampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari ini. Nilai yang ditampilkan valid untuk eksekusi saat ini dan dapat bervariasi di antara eksekusi.
Kuota didasarkan pada jumlah penerima email. Untuk informasi kuota tertentu, lihat Kuota untuk Layanan Google.
const emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);
Pulang pergi
Integer
— Jumlah email yang 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
send Email(message)
Mengirim pesan email. Variasi metode ini jauh lebih fleksibel, sehingga memungkinkan lebih banyak opsi.
// 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, }, }); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
message | Object | objek JavaScript yang mewakili pesan email |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
attachments | Blob | array file yang akan dikirim dengan email |
bcc | String | daftar alamat email yang dipisahkan koma untuk BCC |
body | String | isi email |
cc | String | daftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc |
html | String | jika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya sebagai pengganti
argumen isi yang diperlukan; Anda dapat menambahkan kolom inline opsional di isi
HTML jika telah menyisipkan gambar untuk email |
inline | Object | objek JavaScript yang berisi pemetaan dari kunci gambar (String ) ke data gambar (Blob ); hal ini mengasumsikan bahwa parameter html digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" /> (lihat contoh) |
name | String | nama pengirim email. Setelan default-nya adalah nama pengguna pengirim. |
no | Boolean | true jika email harus dikirim dari alamat email umum yang tidak dapat membalas untuk mencegah penerima merespons email; opsi ini hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail |
reply | String | alamat email yang akan digunakan sebagai alamat balas-ke default
(default: alamat email pengguna). Jika no ditetapkan ke true , reply akan diabaikan. |
subject | String | subjek email |
to | String | alamat email penerima atau daftar alamat email yang dipisahkan koma untuk menjadi 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
send Email(recipient, subject, body)
Mengirim pesan email.
App .sendEmail( 'recipient@example.com', 'TPS reports', 'Where are the TPS reports?', );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
recipient | String | alamat penerima, yang 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
send Email(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. 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], }, );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
recipient | String | alamat penerima, yang dipisahkan dengan koma |
subject | String | baris subjek |
body | String | isi email |
options | Object | objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
attachments | Blob | array file yang akan dikirim dengan email (lihat contoh) |
bcc | String | daftar alamat email yang dipisahkan koma untuk BCC |
cc | String | daftar alamat email yang dipisahkan koma untuk disertakan dalam kolom Cc |
html | String | jika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya sebagai pengganti
argumen isi yang diperlukan; Anda dapat menambahkan kolom inline opsional di isi
HTML jika telah menyisipkan gambar untuk email |
inline | Object | objek JavaScript yang berisi pemetaan dari kunci gambar
(String ) ke data gambar (Blob ); hal ini mengasumsikan bahwa parameter html digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" /> |
name | String | nama pengirim email (default: nama pengguna) |
no | Boolean | true jika email harus dikirim dari alamat email umum yang tidak dapat membalas untuk mencegah penerima merespons email; opsi ini hanya dapat dilakukan untuk akun Google Workspace, bukan pengguna Gmail |
reply | String | alamat email yang akan 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
send Email(to, replyTo, subject, body)
Mengirim pesan email. Metode ini memungkinkan pengguna menentukan alamat Reply-To dengan mudah untuk pesan yang dikirim yang dapat berbeda dengan pengirim.
App .sendEmail( 'recipient@example.com', 'replies@example.com', 'TPS report status', 'What is the status of those TPS reports?', );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
to | String | alamat penerima, yang dipisahkan dengan koma |
reply | String | alamat balas-ke |
subject | String | baris subjek |
body | String | isi email dalam teks biasa |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/script.send_mail