Pengaturan Trigger Google Apps Script

Disclaimer Google Finance

Situs ini menggunakan cookie dari Google untuk memberikan dan meningkatkan kualitas layanannya serta menganalisis lalu lintas. Pelajari lebih lanjut/ Oke, mengerti (This site uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more/ OK, got it)

A. Google Apps Script Overview Settings

B. Google Apps Script Editor Settings

C. Google Apps Script Project History Settings

D. Google Apps Script Trigger Settings

🔔 Pengaturan Trigger Google Apps Script

1. Pilih Fungsi yang Akan Dijalankan
Choose Which Function to Run

Fungsi (Function): 📦 checkStockAlerts – Periksa stok dan beri peringatan (Check for stock alerts) ⏱️ checkAndRunEvery15Sec – Jalankan pengecekan setiap 15 detik (Run every 15 seconds) 🌐 doGet – Tanggapi permintaan HTTP GET (Respond to web GET request)

📝 Keterangan / Note:
🔧 Pilihan fungsi muncul otomatis berdasarkan skrip yang ada fungsi-fungsi functionName() tanpa parameter. Fungsi yang menerima parameter tidak muncul di daftar ini. Pastikan fungsi yang ingin dipicu **tidak memiliki parameter**, karena hanya fungsi tanpa parameter yang dapat dipicu dari trigger manual.
❗Jika hanya ada 1 fungsi di dalam kode, maka hanya satu yang akan muncul di sini.
✔️ Jika ada 3 fungsi seperti di atas, maka ketiganya muncul sebagai pilihan.

Penjelasan & Contoh Fungsi:
– checkStockAlerts: Mengecek stok barang dan mengirimkan peringatan jika stok hampir habis.
Contoh: Jika stok kurang dari 10, sistem akan mengirim email ke bagian gudang.

– checkAndRunEvery15Sec: Digunakan untuk pengecekan rutin, ideal untuk simulasi atau pengujian logika. Perlu dicatat bahwa trigger Google tidak mendukung eksekusi setiap 15 detik secara nyata.
Contoh: Mensimulasikan pengecekan pembaruan data dari API eksternal.

– doGet: Fungsi endpoint yang menangani permintaan dari internet (API publik).
Contoh: Website eksternal mengakses data dari Google Sheets melalui URL fungsi doGet.

2. Pilih Sumber Pemicu
Select Event Source

Sumber Pemicu (Event Source): 📊 Dari Spreadsheet (From Spreadsheet) ⏰ Berdasarkan Waktu (Time-Driven) 📅 Dari Kalender (From Calendar)

Penjelasan & Contoh:
- Dari Spreadsheet: Aktif saat seseorang membuka atau mengedit Google Sheets.
Contoh: Saat pengguna mengubah data, fungsi validasi otomatis dijalankan.
- Berdasarkan Waktu: Aktif secara berkala tanpa interaksi pengguna.
Contoh: Mengirim email laporan setiap pagi jam 7.
- Dari Kalender: Aktif berdasarkan kejadian di Google Kalender.
Contoh: Menambahkan catatan otomatis ketika acara dimulai.

3. Pilih Jenis Pemicu
Select Event Type

Jenis Pemicu (Event Type): 📂 Saat Dibuka (On Open) ✏️ Saat Diedit (On Edit) 🔄 Saat Ada Perubahan (On Change) 📨 Saat Formulir Dikirim (On Form Submit)

Penjelasan & Contoh:
- Saat Dibuka: Fungsi berjalan saat spreadsheet dibuka oleh pengguna.
Contoh: Menyambut pengguna dengan pesan selamat datang.
- Saat Diedit: Fungsi berjalan ketika ada pengeditan sel.
Contoh: Menghitung otomatis total jika kolom harga berubah.
- Saat Ada Perubahan: Mirip onEdit tapi juga mencakup perubahan dari skrip atau impor.
Contoh: Menyimpan data log saat ada perubahan impor data.
- Saat Formulir Dikirim: Hanya aktif jika spreadsheet terhubung dengan Google Form.
Contoh: Mengirim notifikasi ketika seseorang mengisi form pendaftaran.

4. Pengaturan Notifikasi
Notification Preferences

Frekuensi Notifikasi (Notification Frequency): 🚨 Segera (Notify me immediately) 🕐 Setiap Jam (Notify me hourly) 📅 Setiap Hari (Notify me daily) 📆 Setiap Minggu (Notify me weekly)

Penjelasan & Contoh:
- Segera: Dapatkan notifikasi langsung saat terjadi error atau kejadian.
Contoh: Fungsi gagal dan email langsung dikirim.
- Setiap Jam: Ringkasan error atau status akan dikirim tiap jam.
Contoh: Anda mendapat laporan jika ada error selama 1 jam terakhir.
- Setiap Hari: Ringkasan kejadian dikirim setiap hari.
Contoh: Email ringkasan pengiriman form harian.
- Setiap Minggu: Notifikasi mingguan untuk error atau log aktivitas.
Contoh: Laporan mingguan penggunaan sistem absensi.

E. Google Apps Script Execution Settings

Executions

🧐 Apa itu Executions?
Panel Executions di Google Apps Script menampilkan daftar semua fungsi yang dijalankan dalam proyek, baik sukses maupun gagal.

🔁 Apakah tampil real-time?
✅ Ya, jika Anda membuka panel View > Executions dan mencentang "Show real-time log", maka data log akan muncul otomatis saat fungsi dijalankan.
❌ Jika centang dihilangkan, log tetap dicatat, tapi tidak diperbarui otomatis.
⛔ Menutup panel tidak menghentikan proses eksekusi — semua tetap tercatat dan bisa dilihat nanti.

⏱️ Contoh:
Jika Anda membuat fungsi dengan trigger tiap 1 menit, lalu menjalankan script selama 40 menit, maka walau panel executions ditutup, 40 entri tetap tercatat. Saat panel dibuka kembali, seluruh histori akan ditampilkan.

Filters

• Start Time: Menunjukkan waktu ketika eksekusi (script) dimulai.
• Status: Menampilkan status hasil eksekusi, seperti Completed, Failed, atau Timed Out.
• Type: Jenis pemicu atau cara eksekusi, misalnya Time-driven, Manual, atau OnEdit.
• Ran As: Menunjukkan identitas user atau sistem yang menjalankan script, biasanya "user" atau "system".
• Deployment: Menandakan versi deployment yang digunakan (misalnya: HEAD atau Last Deployed).
• Trigger ID: ID unik dari pemicu (trigger) yang menjalankan script, berguna untuk menelusuri atau menghapus trigger tertentu.

F. Google Apps Script Project Settings

General Settings

🔧 Fungsi dan Penjelasan:

• ✅ Log uncaught exceptions to Cloud Logs
  Mengirim error (yang tidak ditangani) ke Google Cloud Logging.
  Contoh: Jika fungsi gagal karena kesalahan sintaks atau API, lognya bisa dilihat lebih detail di Cloud.
• ✅ Enable Chrome V8 Runtime
  Mengaktifkan dukungan fitur JavaScript modern seperti let, const, arrow functions, dan async/await.
  Sebaiknya tetap aktif agar kompatibel dengan fitur modern Apps Script.
• ⬜ Show "appsscript.json" manifest file in editor
  Jika dicentang, Anda bisa melihat dan mengedit file konfigurasi proyek.
  Digunakan untuk mengatur oauthScopes, library, runtimeVersion, dan lainnya.

---

📄 Apa itu Script ID?

Script ID adalah kode unik untuk setiap proyek Google Apps Script. Letaknya ada di bagian bawah Project Settings.
Anda bisa menggunakan Script ID untuk:

• 📦 Mengimpor library dari proyek lain (di Resources > Libraries)
• 🔗 Berbagi akses kode ke proyek tertentu tanpa berbagi seluruh file
• 📤 Menghubungkan dengan API Deployment dari luar (CLI / App Script API)

Contoh Script ID:
1AbCDeFG_hiJkLmNoPQrStUVwXyZ1234567890abcdEfG