Class MailApp

MailApp

Mengirim email.

Layanan ini memungkinkan pengguna mengirim email dengan kontrol penuh atas konten email. Tidak seperti GmailApp, satu-satunya 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

MetodeJenis nilai yang ditampilkanDeskripsi singkat
getRemainingDailyQuota()IntegerMenampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari ini.
sendEmail(message)voidMengirim pesan email.
sendEmail(recipient, subject, body)voidMengirim pesan email.
sendEmail(recipient, subject, body, options)voidMengirim pesan email dengan argumen opsional.
sendEmail(to, replyTo, subject, body)voidMengirim pesan email.

Dokumentasi mendetail

getRemainingDailyQuota()

Menampilkan jumlah penerima yang dapat Anda kirimi email untuk sisa hari ini. Nilai yang ditampilkan valid untuk eksekusi saat ini dan mungkin bervariasi antar-eksekusi.

Kuota didasarkan pada jumlah penerima email. Untuk mengetahui 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 oleh 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, 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

NamaJenisDeskripsi
messageObjectobjek JavaScript yang mewakili pesan email

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]an array file yang akan dikirim dengan email
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
bodyStringisi email
ccStringdaftar alamat email yang dipisahkan koma untuk dimasukkan ke CC
htmlBodyStringJika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan. Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar inline untuk email
inlineImagesObjectobjek JavaScript yang berisi pemetaan dari kunci gambar (String) ke data gambar (BlobSource); ini mengasumsikan bahwa parameter htmlBody digunakan dan berisi referensi ke gambar ini dalam format <img src="cid:imageKey" /> (lihat contoh)
nameStringnama pengirim email. Setelan default-nya adalah nama pengguna pengirim.
noReplyBooleantrue jika email harus dikirim dari alamat email umum no-reply untuk mencegah penerima membalas email; opsi ini hanya mungkin dilakukan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna). Jika noReply ditetapkan ke true, replyTo akan diabaikan.
subjectStringsubjek email
toStringalamat 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

sendEmail(recipient, subject, body)

Mengirim pesan email. 

MailApp.sendEmail(
    'recipient@example.com',
    'TPS reports',
    'Where are the TPS reports?',
);

Parameter

NamaJenisDeskripsi
recipientStringalamat penerima, dipisahkan dengan koma
subjectStringbaris subjek
bodyStringisi 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.
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

NamaJenisDeskripsi
recipientStringalamat penerima, dipisahkan dengan koma
subjectStringbaris subjek
bodyStringisi email
optionsObjectobjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah

Parameter lanjutan

NamaJenisDeskripsi
attachmentsBlobSource[]array file yang akan dikirim dengan email (lihat contoh)
bccStringdaftar alamat email yang dipisahkan koma untuk BCC
ccStringdaftar alamat email yang dipisahkan koma untuk dimasukkan ke CC
htmlBodyStringJika ditetapkan, perangkat yang dapat merender HTML akan menggunakannya, bukan argumen isi yang diperlukan. Anda dapat menambahkan kolom inlineImages opsional di isi HTML jika Anda memiliki gambar inline untuk email
inlineImagesObjectobjek 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" />
nameStringnama pengirim email (default: nama pengguna)
noReplyBooleantrue jika email harus dikirim dari alamat email umum no-reply untuk mencegah penerima membalas email; opsi ini hanya mungkin dilakukan untuk akun Google Workspace, bukan pengguna Gmail
replyToStringalamat 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

sendEmail(to, replyTo, subject, body)

Mengirim pesan email. Metode ini memungkinkan pengguna dengan mudah menentukan alamat Balas-Ke untuk pesan yang dikirim yang dapat berbeda dari pengirim. 

MailApp.sendEmail(
    'recipient@example.com',
    'replies@example.com',
    'TPS report status',
    'What is the status of those TPS reports?',
);

Parameter

NamaJenisDeskripsi
toStringalamat penerima, dipisahkan dengan koma
replyToStringalamat balas-ke
subjectStringbaris subjek
bodyStringisi 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