Halaman ini diterjemahkan oleh Cloud Translation API.

Class MailApp

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 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
`getRemainingDailyQuota()`	`Integer`	Menampilkan jumlah penerima yang dapat Anda kirimi email hingga akhir hari.
`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 hingga akhir hari. Nilai yang ditampilkan valid untuk eksekusi saat ini dan dapat bervariasi antar-eksekusi.

Kuota didasarkan pada jumlah penerima email. Untuk mengetahui informasi kuota tertentu, lihat Kuota untuk Layanan Google.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Return

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, yang memungkinkan lebih banyak opsi.

// 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
      }
  });
}

Parameter

Nama	Jenis	Deskripsi
`message`	`Object`	objek JavaScript yang mewakili pesan email

Parameter lanjutan

Nama	Jenis	Deskripsi
`attachments`	`BlobSource[]`	array file untuk dikirim dengan 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 mampu merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom `inlineImages` opsional dalam isi HTML jika Anda memiliki gambar inline 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. Default-nya adalah nama pengguna pengirim.
`noReply`	`Boolean`	`true` jika email harus dikirim dari alamat email jangan balas email umum agar penerima tidak membalas email; opsi ini hanya dapat digunakan oleh akun Google Workspace, bukan pengguna Gmail
`replyTo`	`String`	alamat email yang akan digunakan sebagai alamat balas-ke default (default: alamat email pengguna). Jika `noReply` disetel ke `true`, `replyTo` akan diabaikan.
`subject`	`String`	subjek email
`to`	`String`	alamat email penerima, atau daftar yang dipisahkan koma berisi alamat email yang akan 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, options)

`sendEmail(recipient, subject, body)`

Mengirim pesan email.

MailApp.sendEmail("recipient@example.com",
                  "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('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, 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[]`	array file untuk 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 mampu merender HTML akan menggunakannya, bukan argumen isi yang diperlukan; Anda dapat menambahkan kolom `inlineImages` opsional dalam isi HTML jika Anda memiliki gambar inline untuk email
`inlineImages`	`Object`	objek 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" />`
`name`	`String`	nama pengirim email (default: nama pengguna)
`noReply`	`Boolean`	`true` jika email harus dikirim dari alamat email jangan balas email umum agar penerima tidak membalas email; opsi ini hanya dapat digunakan oleh akun Google Workspace, bukan pengguna Gmail
`replyTo`	`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

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

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

MailApp.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, dipisahkan dengan koma
`replyTo`	`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