Automasi Kerja Sekolah dengan Google Apps Script: 3 Skrip untuk Bermula
Tiga skrip Google Apps Script yang ringkas untuk guru: cap masa automatik, ringkasan kehadiran mingguan dan e-mel pengesahan borang, lengkap dengan had kuota sebenar dan cara memasang pencetus.

Setiap guru ada tugas yang berulang: menyalin tarikh ke hamparan, menghantar peringatan, merumus kehadiran. Google Apps Script boleh melakukan sebahagiannya secara automatik di dalam Google Sheets dan Google Forms yang sudah anda gunakan. Artikel ini memberi tiga skrip pendek yang boleh disalin, cara memasangnya, dan had sebenar yang perlu anda ketahui sebelum bergantung padanya.
Apa itu Apps Script, dan apa batasnya
Apps Script ialah bahasa skrip berasaskan JavaScript yang dijalankan di pelayan Google dan boleh mengawal Sheets, Docs, Forms dan Gmail. Ia percuma, tetapi ada had harian yang jelas. Angka di bawah diambil daripada halaman kuota rasmi Google:
| Had | Akaun Gmail biasa | Google Workspace (termasuk akaun sekolah) |
|---|---|---|
| Penerima e-mel sehari | 100 | 1,500 |
| Masa larian satu skrip | 6 minit | 6 minit |
| Jumlah masa pencetus sehari | 90 minit | 6 jam |
| Bilangan pencetus setiap pengguna bagi satu skrip | 20 | 20 |
Untuk kerja kelas biasa, had ini mencukupi. Satu perkara lain: pentadbir Workspace sekolah boleh menyekat Apps Script atau penghantaran e-mel pada akaun sekolah, jadi jika skrip tidak boleh dijalankan, tanya pentadbir dahulu.
Sebelum bermula
- Buka Google Sheets, kemudian pilih Extensions dan Apps Script.
- Padam kod contoh dalam editor, tampal skrip, dan tekan Save.
- Kali pertama sesuatu fungsi dijalankan, Google meminta kebenaran. Untuk skrip yang anda tulis sendiri, anda akan melihat amaran bahawa aplikasi belum disahkan. Itu normal untuk skrip peribadi. Teruskan hanya untuk skrip yang anda fahami.
- Uji pada salinan helaian dengan data rekaan, bukan pada data sebenar murid.
Skrip 1: Cap masa automatik
Apabila anda memasukkan atau mengubah markah dalam lajur B, tarikh dan masa ditulis dalam lajur C pada baris yang sama. Ini berguna untuk menunjukkan bila sesuatu markah dikemas kini. Skrip ini menggunakan pencetus ringkas (onEdit) yang tidak perlu dipasang. Namakan helaian anda Markah.
// Cap masa automatik: bila sel dalam lajur B disunting,
// tarikh dan masa ditulis dalam lajur C pada baris yang sama.
function onEdit(e) {
var sheet = e.range.getSheet();
if (sheet.getName() !== 'Markah') return; // hanya helaian bernama "Markah"
var barisPertama = Math.max(e.range.getRow(), 2); // langkau baris tajuk
var barisAkhir = e.range.getRow() + e.range.getNumRows() - 1;
var lajurAwal = e.range.getColumn();
var lajurAkhir = lajurAwal + e.range.getNumColumns() - 1;
if (2 < lajurAwal || 2 > lajurAkhir) return; // suntingan tidak melibatkan lajur B
for (var baris = barisPertama; baris <= barisAkhir; baris++) {
sheet.getRange(baris, 3).setValue(new Date());
}
}
Dua batasan daripada dokumentasi pencetus: pencetus ringkas hanya berjalan apabila seseorang menyunting sel, bukan apabila skrip lain menukar sel (setValue tidak mencetus onEdit), dan ia tidak boleh menghantar e-mel. Untuk e-mel, anda perlukan pencetus yang dipasang, seperti dua skrip seterusnya.
Skrip 2: Ringkasan kehadiran mingguan
Skrip ini membaca helaian bernama Kehadiran (lajur A: kod murid, B: bilangan hari hadir, C: jumlah hari) dan menghantar kepada anda sendiri senarai murid di bawah 80%. Gunakan kod murid seperti M01 hingga M35, bukan nama penuh.
// Ringkasan kehadiran mingguan, dihantar kepada anda sendiri.
// Helaian "Kehadiran": A = kod murid, B = hari hadir, C = jumlah hari.
function hantarRingkasanKehadiran() {
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Kehadiran');
var data = sheet.getDataRange().getValues(); // baris 1 = tajuk
var rendah = [];
for (var i = 1; i < data.length; i++) {
var kod = data[i][0];
var hadir = Number(data[i][1]);
var jumlah = Number(data[i][2]);
if (!kod || !jumlah) continue; // langkau baris kosong
var peratus = Math.round((hadir / jumlah) * 100);
if (peratus < 80) rendah.push(kod + ': ' + peratus + '%');
}
var badan = rendah.length
? 'Murid dengan kehadiran di bawah 80%:\n' + rendah.join('\n')
: 'Semua murid berada pada 80% ke atas.';
var penerima = Session.getEffectiveUser().getEmail();
MailApp.sendEmail(penerima, 'Ringkasan kehadiran mingguan', badan);
}
// Jalankan SEKALI sahaja untuk memasang pencetus setiap hari Jumaat, sekitar 4 petang.
function pasangPencetusMingguan() {
ScriptApp.newTrigger('hantarRingkasanKehadiran')
.timeBased()
.onWeekDay(ScriptApp.WeekDay.FRIDAY)
.atHour(16)
.create();
}
Untuk menjadikannya automatik, jalankan fungsi pasangPencetusMingguan sekali sahaja. Pencetus yang dipasang akan menjalankan hantarRingkasanKehadiran setiap hari Jumaat, pada masa antara 4 dan 5 petang. Pastikan fail appsscript.json projek anda mempunyai "timeZone": "Asia/Kuala_Lumpur" supaya waktu itu mengikut waktu Malaysia (lihat dokumentasi manifes).
Skrip 3: E-mel pengesahan apabila borang dihantar
Sambungkan Google Form anda kepada Sheets (tab Responses, kemudian Link to Sheets). Setiap kali borang dihantar, skrip ini menghantar e-mel pengesahan kepada alamat yang diisi. Borang mesti mempunyai dua soalan bertajuk tepat Nama murid dan E-mel penjaga. Jika tajuk soalan berbeza, tukar kunci dalam skrip supaya sepadan.
// Hantar e-mel pengesahan apabila Google Form dihantar.
// Nama kunci mesti SAMA dengan tajuk soalan dalam borang.
function hantarPengesahan(e) {
var nama = e.namedValues['Nama murid'] && e.namedValues['Nama murid'][0];
var emel = e.namedValues['E-mel penjaga'] && e.namedValues['E-mel penjaga'][0];
if (!nama || !emel) return; // soalan tiada atau kosong
MailApp.sendEmail(
emel,
'Borang kebenaran diterima',
'Borang bagi ' + nama + ' telah diterima. Terima kasih.'
);
}
// Jalankan SEKALI sahaja untuk memasang pencetus borang pada helaian ini.
function pasangPencetusBorang() {
ScriptApp.newTrigger('hantarPengesahan')
.forSpreadsheet(SpreadsheetApp.getActiveSpreadsheet())
.onFormSubmit()
.create();
}
Pasang pencetus dengan menjalankan pasangPencetusBorang sekali. Kunci namedValues ialah tajuk soalan, dan setiap kunci memegang senarai jawapan (sebab itu kod menggunakan [0]). Butiran acara ini ada dalam dokumentasi acara pencetus.
Dua peringatan. Pertama, kutip e-mel penjaga hanya jika sekolah anda membenarkannya dan penjaga tahu tujuannya; ikut dasar privasi sekolah dan PPD. Kedua, had 100 e-mel sehari pada akaun biasa bermakna borang yang diisi oleh lebih ramai orang akan berhenti menghantar e-mel selepas had itu.
Masalah yang biasa berlaku
- E-mel dihantar dua kali. Anda menjalankan fungsi pasang pencetus lebih daripada sekali. Buka ikon jam (Triggers) di sebelah kiri editor dan padam yang berganda.
- Cap masa tidak muncul. Semak nama helaian (huruf besar dan kecil dibezakan), dan pastikan anda menyunting lajur B dengan tangan.
- Borang tidak menghantar e-mel. Tajuk soalan tidak sama dengan kunci dalam skrip, atau pencetus belum dipasang. Semak tab Executions untuk mesej ralat.
- Ralat kuota e-mel. Had harian sudah dicapai. Ia ditetapkan semula keesokan harinya.
Mulakan dengan satu
Cuba skrip 1 dahulu pada salinan helaian anda kerana ia tidak memerlukan pemasangan pencetus. Apabila anda selesa, tambah skrip 2 dengan data kehadiran rekaan, dan hanya selepas itu gunakan data sebenar. Logik setiap skrip dalam artikel ini diuji dengan data rekaan sebelum diterbitkan, tetapi tetapan sekolah, kebenaran akaun dan struktur helaian anda berbeza, jadi ujian pada salinan sendiri tetap perlu.
Rujukan
- Apps Script: Quotas for Google Services
- Apps Script: Triggers
- Apps Script: Installable Triggers
- Apps Script: Event Objects
- Apps Script: MailApp
- Apps Script: ClockTriggerBuilder
Buku tentang Google Apps Script di Amazon (pautan afiliasi: saya mungkin menerima komisen kecil tanpa kos tambahan kepada anda).
Nota penyunting: Artikel ini disediakan dengan bantuan alat AI, kemudian disemak dan disunting oleh Ts. Ashraf bin Naim sebelum diterbitkan. Contoh dan saranan di dalamnya berdasarkan pengalaman sebenar dalam pentadbiran dan latihan pendidikan di Malaysia.
Tentang Ts. Ashraf bin Naim
Pendidik dan teknologis profesional yang melatih guru menggunakan AI dan alat digital dalam kerja harian mereka.


