Halaman ini diterjemahkan oleh Cloud Translation API.

Script Service

Layanan ini menyediakan akses ke pemicu skrip dan publikasi skrip.

Class

Nama	Deskripsi singkat
`AuthMode`	Enumerasi yang mengidentifikasi kategori layanan resmi yang dapat dieksekusi Apps Script melalui fungsi yang dipicu.
`AuthorizationInfo`	Objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk cakupan skrip yang diperlukan.
`AuthorizationStatus`	Enumerasi yang menunjukkan status otorisasi skrip.
`CalendarTriggerBuilder`	Builder untuk pemicu kalender.
`ClockTriggerBuilder`	Builder untuk pemicu waktu.
`DocumentTriggerBuilder`	Builder untuk pemicu dokumen.
`EventType`	Enumerasi yang menunjukkan jenis peristiwa yang dipicu.
`FormTriggerBuilder`	Builder untuk pemicu formulir.
`InstallationSource`	Enumerasi yang menunjukkan cara skrip diinstal sebagai add-on untuk pengguna saat ini.
`ScriptApp`	Mengakses dan memanipulasi publikasi dan pemicu skrip.
`Service`	Mengakses dan memanipulasi publikasi skrip.
`SpreadsheetTriggerBuilder`	Builder untuk pemicu spreadsheet.
`StateTokenBuilder`	Mengizinkan skrip membuat token status yang dapat digunakan di API callback (seperti alur OAuth).
`Trigger`	Pemicu skrip.
`TriggerBuilder`	Builder generik untuk pemicu skrip.
`TriggerSource`	Enumerasi yang menunjukkan sumber peristiwa yang menyebabkan pemicu diaktifkan.

`AuthMode`

Properti

Properti	Jenis	Deskripsi
`NONE`	`Enum`	Mode yang tidak mengizinkan akses ke layanan apa pun yang memerlukan otorisasi.
`CUSTOM_FUNCTION`	`Enum`	Mode yang memungkinkan akses ke sebagian kecil layanan untuk digunakan dalam fungsi spreadsheet kustom.
`LIMITED`	`Enum`	Mode yang memungkinkan akses ke sebagian kecil layanan.
`FULL`	`Enum`	Mode yang memungkinkan akses ke semua layanan yang memerlukan otorisasi.

`AuthorizationInfo`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getAuthorizationStatus()`	`AuthorizationStatus`	Mendapatkan nilai yang menunjukkan apakah pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String\|null`	Mendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip.
`getAuthorizedScopes()`	`String[]\|null`	Mendapatkan daftar cakupan yang diizinkan untuk skrip.

`AuthorizationStatus`

Properti

Properti	Jenis	Deskripsi
`REQUIRED`	`Enum`	Pengguna harus mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan.
`NOT_REQUIRED`	`Enum`	Pengguna telah memberikan semua otorisasi yang saat ini diperlukan oleh skrip ini.

`CalendarTriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`create()`	`Trigger`	Membuat pemicu dan menampilkannya.
`onEventUpdated()`	`CalendarTriggerBuilder`	Menentukan pemicu yang diaktifkan saat entri kalender dibuat, diperbarui, atau dihapus.

`ClockTriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Menentukan durasi minimum (dalam milidetik) setelah waktu saat ini saat pemicu berjalan.
`at(date)`	`ClockTriggerBuilder`	Menentukan waktu pemicu berjalan.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Menentukan bahwa pemicu diaktifkan pada tanggal yang ditentukan, secara default mendekati tengah malam (+/- 15 menit).
`atHour(hour)`	`ClockTriggerBuilder`	Menentukan jam pemicu dijalankan.
`create()`	`Trigger`	Membuat pemicu.
`everyDays(n)`	`ClockTriggerBuilder`	Menentukan untuk menjalankan pemicu setiap `n` hari.
`everyHours(n)`	`ClockTriggerBuilder`	Menentukan untuk menjalankan pemicu setiap `n` jam.
`everyMinutes(n)`	`ClockTriggerBuilder`	Menentukan untuk menjalankan pemicu setiap `n` menit.
`everyWeeks(n)`	`ClockTriggerBuilder`	Menentukan untuk menjalankan pemicu setiap `n` minggu.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Menentukan zona waktu untuk tanggal/waktu yang ditentukan saat pemicu berjalan.
`nearMinute(minute)`	`ClockTriggerBuilder`	Menentukan menit saat pemicu berjalan (plus atau minus 15 menit).
`onMonthDay(day)`	`ClockTriggerBuilder`	Menentukan tanggal dalam bulan saat pemicu berjalan.
`onWeekDay(day)`	`ClockTriggerBuilder`	Menentukan hari dalam seminggu saat pemicu berjalan.

`DocumentTriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`create()`	`Trigger`	Membuat dan menampilkan pemicu baru.
`onOpen()`	`DocumentTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat dokumen dibuka.

`EventType`

Properti

Properti	Jenis	Deskripsi
`CLOCK`	`Enum`	Pemicu diaktifkan setelah peristiwa berbasis waktu mencapai waktu tertentu.
`ON_OPEN`	`Enum`	Pemicu diaktifkan setelah pengguna membuka file Google Dokumen, Spreadsheet, atau Formulir.
`ON_EDIT`	`Enum`	Pemicu akan diaktifkan setelah pengguna mengedit file Google Spreadsheet (misalnya, dengan memasukkan nilai baru ke dalam sel, yang dihitung sebagai pengeditan, bukan perubahan).
`ON_FORM_SUBMIT`	`Enum`	Pemicu diaktifkan setelah pengguna merespons Google Formulir.
`ON_CHANGE`	`Enum`	Pemicu akan diaktifkan setelah pengguna mengubah file Google Spreadsheet (misalnya, dengan menambahkan baris, yang dihitung sebagai perubahan, bukan pengeditan).
`ON_EVENT_UPDATED`	`Enum`	Pemicu diaktifkan setelah acara dibuat, diperbarui, atau dihapus di Google Kalender yang ditentukan.

`FormTriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`create()`	`Trigger`	Membuat dan menampilkan pemicu baru.
`onFormSubmit()`	`FormTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat respons dikirimkan ke formulir.
`onOpen()`	`FormTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat tampilan edit formulir dibuka.

`InstallationSource`

Properti

Properti	Jenis	Deskripsi
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	Add-on diinstal oleh administrator untuk domain pengguna.
`NONE`	`Enum`	Skrip tidak berjalan sebagai add-on.
`WEB_STORE_ADD_ON`	`Enum`	Add-on diinstal oleh pengguna dari Chrome Web Store.

`ScriptApp`

Properti

Properti	Jenis	Deskripsi
`AuthMode`	`AuthMode`	Enumerasi yang mengidentifikasi kategori layanan resmi yang dapat dieksekusi Apps Script melalui fungsi yang dipicu.
`AuthorizationStatus`	`AuthorizationStatus`	Enumerasi yang menunjukkan status otorisasi skrip.
`EventType`	`EventType`	Enumerasi yang menunjukkan jenis peristiwa yang dipicu.
`InstallationSource`	`InstallationSource`	Enumerasi yang menunjukkan cara skrip diinstal ke pengguna sebagai add-on.
`TriggerSource`	`TriggerSource`	Enumerasi yang menunjukkan sumber peristiwa yang menyebabkan pemicu diaktifkan.
`WeekDay`	`Weekday`	Enumerasi yang merepresentasikan hari dalam seminggu.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`deleteTrigger(trigger)`	`void`	Menghapus pemicu tertentu sehingga tidak lagi berjalan.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Mendapatkan objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk semua persyaratan skrip.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Mendapatkan objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk cakupan yang diminta.
`getIdentityToken()`	`String\|null`	Mendapatkan token identitas OpenID Connect untuk pengguna efektif, jika cakupan `openid` telah diberikan.
`getInstallationSource()`	`InstallationSource`	Menampilkan nilai enum yang menunjukkan cara skrip diinstal sebagai add-on untuk pengguna saat ini (misalnya, apakah pengguna menginstalnya secara pribadi melalui Chrome Web Store, atau apakah administrator domain menginstalnya untuk semua pengguna).
`getOAuthToken()`	`String`	Mendapatkan token akses OAuth 2.0 untuk pengguna yang efektif.
`getProjectTriggers()`	`Trigger[]`	Mendapatkan semua pemicu yang dapat diinstal yang terkait dengan project saat ini dan pengguna saat ini.
`getScriptId()`	`String`	Mendapatkan ID unik project skrip.
`getService()`	`Service`	Mendapatkan objek yang digunakan untuk mengontrol publikasi skrip sebagai aplikasi web.
`getUserTriggers(document)`	`Trigger[]`	Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini dalam dokumen tertentu, hanya untuk skrip atau add-on ini.
`getUserTriggers(form)`	`Trigger[]`	Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini dalam formulir tertentu, hanya untuk skrip atau add-on ini.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini di spreadsheet tertentu, hanya untuk skrip atau add-on ini.
`invalidateAuth()`	`void`	Membatalkan otorisasi yang dimiliki pengguna efektif untuk menjalankan skrip saat ini.
`newStateToken()`	`StateTokenBuilder`	Membuat builder untuk token status yang dapat digunakan di API callback (seperti alur OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	Memulai proses pembuatan pemicu yang dapat diinstal yang, saat dipicu, memanggil fungsi tertentu.
`requireAllScopes(authMode)`	`void`	Memvalidasi apakah pengguna telah memberikan izin untuk semua cakupan yang diminta oleh skrip.
`requireScopes(authMode, oAuthScopes)`	`void`	Memvalidasi apakah pengguna telah memberikan izin untuk cakupan yang diminta.

`Service`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getUrl()`	`String`	Menampilkan URL aplikasi web, jika telah di-deploy; jika tidak, menampilkan `null`.
`isEnabled()`	`Boolean`	Menampilkan `true` jika skrip dapat diakses sebagai aplikasi web.

`SpreadsheetTriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`create()`	`Trigger`	Membuat pemicu dan menampilkannya.
`onChange()`	`SpreadsheetTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat konten atau struktur spreadsheet diubah.
`onEdit()`	`SpreadsheetTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat spreadsheet diedit.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat spreadsheet memiliki formulir yang dikirimkan ke dalamnya.
`onOpen()`	`SpreadsheetTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat spreadsheet dibuka.

`StateTokenBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`createToken()`	`String`	Membangun representasi string terenkripsi dari token status.
`withArgument(name, value)`	`StateTokenBuilder`	Menambahkan argumen ke token.
`withMethod(method)`	`StateTokenBuilder`	Menetapkan fungsi callback.
`withTimeout(seconds)`	`StateTokenBuilder`	Menetapkan durasi (dalam detik) validitas token.

`Trigger`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getEventType()`	`EventType`	Menampilkan jenis peristiwa yang memicu pemicu.
`getHandlerFunction()`	`String`	Menampilkan fungsi yang akan dipanggil saat pemicu diaktifkan.
`getTriggerSource()`	`TriggerSource`	Menampilkan sumber peristiwa yang akan menyebabkan pemicu diaktifkan.
`getTriggerSourceId()`	`String`	Menampilkan ID khusus untuk sumber.
`getUniqueId()`	`String`	Menampilkan ID unik yang dapat digunakan untuk membedakan pemicu satu sama lain.

`TriggerBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`forDocument(document)`	`DocumentTriggerBuilder`	Membuat dan menampilkan `DocumentTriggerBuilder` yang terkait dengan dokumen tertentu.
`forDocument(key)`	`DocumentTriggerBuilder`	Membuat dan menampilkan `DocumentTriggerBuilder` yang terkait dengan dokumen dengan ID yang diberikan.
`forForm(form)`	`FormTriggerBuilder`	Membuat dan menampilkan `FormTriggerBuilder` yang terkait dengan formulir yang diberikan.
`forForm(key)`	`FormTriggerBuilder`	Membuat dan menampilkan `FormTriggerBuilder` yang terkait dengan formulir dengan ID yang diberikan.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Membuat dan menampilkan `SpreadsheetTriggerBuilder` yang terkait dengan spreadsheet tertentu.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Membuat dan menampilkan `SpreadsheetTriggerBuilder` yang terkait dengan spreadsheet dengan ID yang diberikan.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Menampilkan builder untuk membuat pemicu kalender.
`timeBased()`	`ClockTriggerBuilder`	Membuat dan menampilkan `ClockTriggerBuilder` untuk membuat pemicu berbasis waktu.

`TriggerSource`

Properti

Properti	Jenis	Deskripsi
`SPREADSHEETS`	`Enum`	Google Spreadsheet menyebabkan pemicu diaktifkan.
`CLOCK`	`Enum`	Peristiwa yang didorong waktu menyebabkan pemicu diaktifkan.
`FORMS`	`Enum`	Google Formulir menyebabkan pemicu diaktifkan.
`DOCUMENTS`	`Enum`	Google Dokumen menyebabkan pemicu diaktifkan.
`CALENDAR`	`Enum`	Google Kalender menyebabkan pemicu diaktifkan.

Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.

Terakhir diperbarui pada 2025-12-11 UTC.

Blog
Baca blog Developer Google Workspace
Stack Overflow
Ajukan pertanyaan dengan tag google-apps-script
Contoh Kode
Pelajari contoh kode kami atau salin untuk membuat kode Anda sendiri
Video
Tonton tutorial Apps Script