Objek Peristiwa

Pemicu sederhana dan pemicu yang dapat diinstal memungkinkan Apps Script menjalankan fungsi secara otomatis jika peristiwa tertentu terjadi. Saat pemicu diaktifkan, Apps Script meneruskan objek peristiwa ke fungsi sebagai argumen, biasanya disebut e. Objek peristiwa berisi informasi tentang konteks yang menyebabkan pemicu diaktifkan. Misalnya, kode contoh di bawah menunjukkan pemicu onEdit(e) sederhana untuk skrip Google Spreadsheet yang menggunakan objek peristiwa untuk menentukan sel mana yang diedit.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

Halaman ini menjelaskan kolom dalam objek peristiwa untuk berbagai jenis pemicu.

Peristiwa yang dihasilkan oleh pemicu yang dapat diinstal berisi triggerUid yang mengidentifikasi pemicu yang menghasilkan peristiwa. Hal ini berguna untuk skrip yang memiliki beberapa pemicu yang dapat diinstal.

Acara Google Spreadsheet

Berbagai pemicu khusus Google Spreadsheet memungkinkan skrip merespons tindakan pengguna dalam spreadsheet.

Buka (sederhana dan dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. LIMITED
source	Objek Spreadsheet yang mewakili file Google Spreadsheet tempat skrip terikat. Spreadsheet
triggerUid	ID pemicu yang menghasilkan peristiwa ini (khusus pemicu yang dapat diinstal). 4034124084959907503
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]

Ubah (dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. FULL
changeType	Jenis perubahan (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT, atau OTHER). INSERT_ROW
source	Objek Spreadsheet, yang merepresentasikan file Google Spreadsheet yang terikat dengan skrip. Spreadsheet
triggerUid	ID pemicu yang menghasilkan peristiwa ini. 4034124084959907503
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]

Edit (sederhana dan dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. LIMITED
oldValue	Nilai sel sebelum pengeditan, jika ada. Hanya tersedia jika rentang yang diedit adalah satu sel. Akan tidak ditentukan jika sel tidak memiliki konten sebelumnya. 1234
range	Objek Range, yang merepresentasikan sel atau rentang sel yang diedit. Range
source	Objek Spreadsheet yang mewakili file Google Spreadsheet tempat skrip terikat. Spreadsheet
triggerUid	ID pemicu yang menghasilkan peristiwa ini (khusus pemicu yang dapat diinstal). 4034124084959907503
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]
value	Nilai sel baru setelah pengeditan. Hanya tersedia jika rentang yang diedit adalah satu sel. 10

Kirim formulir (dapat diinstal)
Perhatian: Pastikan Anda menggunakan pemicu pengiriman formulir ini dengan SpreadsheetTriggerBuilder.
authMode	Nilai dari enum ScriptApp.AuthMode. FULL
namedValues	Objek yang berisi nama dan nilai pertanyaan dari pengiriman formulir. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	Objek Range, yang merepresentasikan sel atau rentang sel yang diedit. Range
triggerUid	ID pemicu yang menghasilkan peristiwa ini. 4034124084959907503
values	Array dengan nilai dalam urutan yang sama seperti yang muncul di spreadsheet. ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Acara Google Dokumen

Pemicu memungkinkan Google Dokumen merespons saat pengguna membuka dokumen.

Buka (sederhana dan dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. LIMITED
source	Objek Document, yang mewakili file Google Dokumen tempat skrip terikat. Document
triggerUid	ID pemicu yang menghasilkan peristiwa ini (khusus pemicu yang dapat diinstal). 4034124084959907503
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]

Peristiwa Google Slide

Pemicu memungkinkan Google Slide merespons saat pengguna membuka presentasi.

Buka (sederhana)
authMode	Nilai dari enum ScriptApp.AuthMode. LIMITED
source	Objek Presentation, yang merepresentasikan file Google Slide tempat skrip terikat. Presentation
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]

Acara Google Formulir

Pemicu khusus Google Formulir memungkinkan skrip merespons saat pengguna mengedit formulir atau mengirimkan respons.

Buka * (sederhana dan dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. LIMITED
source	Objek Form, yang merepresentasikan file Google Formulir tempat skrip terikat. Form
triggerUid	ID pemicu yang menghasilkan peristiwa ini (khusus pemicu yang dapat diinstal). 4034124084959907503
user	Objek User, yang merepresentasikan pengguna aktif, jika tersedia (bergantung pada serangkaian batasan keamanan yang kompleks). [e-mail]

* Peristiwa ini tidak terjadi saat pengguna membuka formulir untuk merespons, melainkan saat editor membuka formulir untuk mengubahnya.

Kirim formulir (dapat diinstal)
Perhatian: Pastikan Anda menggunakan pemicu pengiriman formulir ini dengan FormTriggerBuilder.
authMode	Nilai dari enum ScriptApp.AuthMode. FULL
response	Objek FormResponse, yang merepresentasikan respons pengguna terhadap formulir secara keseluruhan. FormResponse
source	Objek Form, yang merepresentasikan file Google Formulir tempat skrip terikat. Form
triggerUid	ID pemicu yang menghasilkan peristiwa ini. 4034124084959907503

Acara Google Kalender

Pemicu kalender diaktifkan saat acara kalender pengguna diperbarui (dibuat, diedit, atau dihapus).

Pemicu ini tidak memberi tahu Anda peristiwa mana yang berubah atau bagaimana perubahannya. Sebaliknya, hal ini menunjukkan bahwa kode Anda perlu melakukan operasi sinkronisasi inkremental untuk mengambil perubahan terbaru pada kalender. Untuk mengetahui deskripsi lengkap prosedur ini, lihat Panduan menyinkronkan resource untuk Calendar API.

Untuk menyinkronkan dengan Kalender di Apps Script, lakukan langkah-langkah berikut:

1. Aktifkan layanan lanjutan Kalender untuk project skrip. Layanan Kalender bawaan tidak cukup untuk alur kerja ini.
2. Tentukan kalender mana yang harus disinkronkan. Untuk setiap kalender tersebut, lakukan operasi sinkronisasi awal menggunakan metode Events.list() layanan lanjutan Kalender.
3. Hasil sinkronisasi awal menampilkan nextSyncToken untuk kalender tersebut. Simpan token ini untuk digunakan nanti.
4. Saat pemicu EventUpdated Apps Script diaktifkan yang menunjukkan perubahan acara kalender, lakukan sinkronisasi inkremental untuk kalender yang terpengaruh menggunakan nextSyncToken yang disimpan. Pada dasarnya, ini adalah permintaan Events.list() lain, tetapi dengan memberikan nextSyncToken, respons akan dibatasi hanya untuk peristiwa yang telah berubah sejak sinkronisasi terakhir.
5. Periksa respons sinkronisasi untuk mempelajari peristiwa yang diperbarui dan buat kode Anda merespons dengan tepat. Misalnya, Anda dapat mencatat perubahan, memperbarui spreadsheet, mengirimkan pemberitahuan email, atau melakukan tindakan lainnya.
6. Perbarui nextSyncToken yang Anda simpan untuk kalender tersebut dengan nextSyncToken yang ditampilkan oleh permintaan sinkronisasi inkremental. Tindakan ini akan memaksa operasi sinkronisasi berikutnya untuk hanya menampilkan perubahan terbaru.

Perhatian: Terkadang token sinkronisasi dibatalkan validasinya oleh server, sehingga menghasilkan error 410. Jika hal ini terjadi, kode Anda harus melakukan sinkronisasi penuh dan mengganti semua data dan token yang disinkronkan yang disimpan untuk kalender tersebut.

EventUpdated (dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. FULL
calendarId	ID string kalender tempat pembaruan acara terjadi. [e-mail]
triggerUid	ID pemicu yang menghasilkan peristiwa ini. 4034124084959907503

Peristiwa add-on Google Workspace

Pemicu onInstall() berjalan secara otomatis saat pengguna menginstal add-on.

Instal (sederhana)
authMode	Nilai dari enum ScriptApp.AuthMode. FULL

Peristiwa aplikasi Google Chat

Untuk mempelajari objek peristiwa di Google Chat, lihat Menerima dan menanggapi interaksi dengan aplikasi Google Chat Anda.

Acara yang dipicu waktu

Pemicu berbasis waktu (juga disebut pemicu jam) memungkinkan skrip dijalankan pada waktu tertentu atau pada interval berulang.

Dipicu waktu (dapat diinstal)
authMode	Nilai dari enum ScriptApp.AuthMode. FULL
day-of-month	Antara 1 dan 31. Karena nama properti ini berisi tanda hubung, properti ini harus diakses melalui e['day-of-month'], bukan notasi titik. 31
day-of-week	Antara 1 (Senin) dan 7 (Minggu). Karena nama properti ini berisi tanda hubung, properti ini harus diakses melalui e['day-of-week'], bukan notasi titik. 7
hour	Antara 0 dan 23. 23
minute	Antara 0 dan 59. 59
month	Antara 1 dan 12. 12
second	Antara 0 dan 59. 59
timezone	Zona waktu. UTC
triggerUid	ID pemicu yang menghasilkan peristiwa ini. 4034124084959907503
week-of-year	Antara 1 dan 52. Karena nama properti ini berisi tanda hubung, properti ini harus diakses melalui e['week-of-year'], bukan notasi titik. 52
year	Tahun. 2015