Seri 4: Trigger dan Event Otomatis di Google Apps Script

Setelah kita belajar mengotomasi Google sheets menggunakan script,  pada  seri ini, kita akan mempelajari bagaimana cara membuat script yang berjalan otomatis menggunakan Trigger di Google Apps Script (GAS). Kita juga akan mempraktikkan contoh nyata — misalnya mengirim email otomatis ketika spreadsheet diubah, atau menjalankan tugas rutin setiap jam.

---

🔍 Apa Itu Trigger?

Trigger adalah pemicu yang membuat fungsi tertentu berjalan secara otomatis berdasarkan event tertentu.
Dengan trigger, kita tidak perlu klik tombol Run setiap kali ingin menjalankan script.

Secara umum, ada dua jenis trigger di GAS:

1. Simple Trigger (Trigger Sederhana)
   Contoh: onOpen(), onEdit(), onInstall()
   → Tidak perlu diset di menu mana pun, otomatis aktif.

2. Installable Trigger (Trigger yang Diinstal)
   → Bisa diatur waktu, event, atau sumber dokumen tertentu.
   → Dibuat melalui editor atau script.

---

⚙️ 1. Simple Trigger: onOpen() dan onEdit()

Simple trigger dijalankan otomatis ketika peristiwa tertentu terjadi.

Misalnya, kita ingin menampilkan pesan selamat datang saat file Spreadsheet dibuka.

function onOpen() {
  SpreadsheetApp.getUi()
    .alert('Selamat datang di spreadsheet otomatis kita!');
}

💡 Fungsi ini harus bernama tepat onOpen(), tidak bisa diganti nama lain.

Begitu juga dengan onEdit(), yang akan otomatis berjalan setiap kali ada sel yang diubah:

function onEdit(e) {
  const range = e.range;
  const value = e.value;
  
  Logger.log(`Sel ${range.getA1Notation()} diubah menjadi: ${value}`);
}

📘 Catatan penting:

• Simple trigger tidak bisa mengakses layanan berhak istimewa (seperti Gmail, Calendar, atau Drive dengan izin penuh).

• Jika kita butuh itu, gunakan Installable Trigger.

---

🕐 2. Installable Trigger: Mengatur Waktu atau Event

Installable trigger bisa kita atur agar fungsi berjalan otomatis pada interval waktu tertentu, atau ketika event spesifik terjadi.

📅 Contoh: Menjalankan Script Setiap Hari

Misalnya kita ingin mengirim laporan otomatis setiap pagi pukul 7.

function kirimLaporanHarian() {
  MailApp.sendEmail(
    "tim@perusahaan.com",
    "Laporan Harian",
    "Halo tim, ini laporan otomatis dari Google Apps Script kita."
  );
}

Sekarang kita tambahkan trigger-nya:

1. Buka menu Triggers di Apps Script (Ikon jam ⏰ di toolbar kiri).
   
   

   
   
   
   

2. Klik + Add Trigger.

3. Pilih fungsi kirimLaporanHarian.

4. Pilih event type: Time-driven.

5. Atur agar berjalan Setiap hari – 7 pagi.

6. Klik Save.

Setelah itu, GAS akan menjalankan fungsi ini otomatis setiap hari pukul 07.00!

---

✨ 3. Trigger Berbasis Event Spreadsheet

Kita juga bisa membuat trigger yang berjalan saat Spreadsheet diubah oleh siapa pun.

Misalnya kita ingin otomatis menandai baris sebagai “Sudah Diperbarui” saat kolom tertentu diubah:

function onEdit(e) {
  const sheet = e.source.getActiveSheet();
  const range = e.range;
  
  if (range.getColumn() === 2) { // Jika kolom B diubah
    sheet.getRange(range.getRow(), 3).setValue('Sudah Diperbarui');
  }
}

Setiap kali kolom B berubah, kolom C akan otomatis terisi teks "Sudah Diperbarui".
Sederhana tapi sangat berguna untuk otomatisasi pelacakan data.

---

🚀 4. Membuat Trigger Melalui Script

Kita juga bisa membuat installable trigger langsung lewat kode, bukan manual dari UI.

function buatTriggerOtomatis() {
  ScriptApp.newTrigger('kirimLaporanHarian')
    .timeBased()
    .everyDays(1)
    .atHour(7)
    .create();
}

💡 Jalankan buatTriggerOtomatis() sekali saja, dan Google akan menjadwalkan trigger otomatis harian untuk kita.

---

🧠 Tips Praktis

• Gunakan Logger.log() untuk debugging fungsi yang dijalankan oleh trigger.

• Untuk fungsi onEdit(e), parameter e menyimpan info seperti range, value, dan user.

• Gunakan try...catch untuk menangani error agar script tidak berhenti mendadak.

Contoh:

function onEdit(e) {
  try {
    const value = e.value;
    Logger.log('Nilai baru:', value);
  } catch (error) {
    Logger.log('Terjadi kesalahan: ' + error);
  }
}

---

Pada seri ini kita telah belajar:

• Apa itu trigger dan jenis-jenisnya.

• Cara membuat onOpen() dan onEdit().

• Cara menjadwalkan fungsi otomatis harian.

• Dan cara membuat trigger lewat script.

Dengan trigger, kita bisa membuat Spreadsheet atau Dokumen yang “hidup”, bereaksi otomatis tanpa kita jalankan manual — inilah salah satu kekuatan utama Google Apps Script.

---

🔜 Seri Selanjutnya

➡️ Seri 5: Mengirim Email Otomatis dengan Template Dinamis

Kita akan belajar membuat sistem pengiriman email otomatis menggunakan GmailApp, lengkap dengan variabel dinamis dari Spreadsheet.