Halaman ini diterjemahkan oleh Cloud Translation API.

Script Service

Layanan ini memberikan akses ke pemicu skrip dan publikasi skrip.

Class

Nama	Deskripsi singkat
`AuthMode`	Enumerasi yang mengidentifikasi kategori layanan yang diizinkan Apps Script yang dapat dieksekusi melalui fungsi yang dipicu.
`AuthorizationInfo`	Objek yang digunakan untuk menentukan apakah pengguna perlu memberikan otorisasi pada skrip ini untuk menggunakan satu atau beberapa layanan, dan memberikan URL untuk dialog otorisasi.
`AuthorizationStatus`	Enumerasi yang menunjukkan status otorisasi skrip.
`CalendarTriggerBuilder`	Builder untuk pemicu kalender.
`ClockTriggerBuilder`	Builder untuk pemicu jam.
`DocumentTriggerBuilder`	Builder untuk pemicu dokumen.
`EventType`	Enumerasi yang menunjukkan jenis peristiwa yang dipicu.
`FormTriggerBuilder`	Builder untuk pemicu formulir.
`InstallationSource`	Enumerasi yang menunjukkan bagaimana skrip diinstal sebagai add-on untuk pengguna saat ini.
`ScriptApp`	Mengakses dan memanipulasi publikasi skrip dan pemicu.
`Service`	Mengakses dan memanipulasi publikasi skrip.
`SpreadsheetTriggerBuilder`	Builder untuk pemicu spreadsheet.
`StateTokenBuilder`	Mengizinkan skrip untuk membuat token status yang dapat digunakan di callback API (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 subset layanan terbatas untuk digunakan dalam fungsi spreadsheet kustom.
`LIMITED`	`Enum`	Mode yang memungkinkan akses ke {i>subset<i} layanan yang terbatas.
`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`	Mendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip.

`AuthorizationStatus`

Properti

Properti	Jenis	Deskripsi
`REQUIRED`	`Enum`	Pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan.
`NOT_REQUIRED`	`Enum`	Pengguna telah memberikan semua otorisasi yang diperlukan untuk 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 pemicu berjalan.
`at(date)`	`ClockTriggerBuilder`	Menentukan kapan 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 saat pemicu berjalan.
`create()`	`Trigger`	Membuat pemicu.
`everyDays(n)`	`ClockTriggerBuilder`	Mendefinisikan untuk menjalankan pemicu setiap `n` hari.
`everyHours(n)`	`ClockTriggerBuilder`	Menyatakan agar pemicu dijalankan setiap `n` jam.
`everyMinutes(n)`	`ClockTriggerBuilder`	Menyatakan 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 diaktifkan setelah pengguna mengedit file Google Spreadsheet (misalnya, dengan memasukkan nilai baru ke dalam sel, yang dihitung sebagai edit, bukan perubahan).
`ON_FORM_SUBMIT`	`Enum`	Pemicu diaktifkan setelah pengguna merespons Formulir Google.
`ON_CHANGE`	`Enum`	Pemicu diaktifkan setelah pengguna mengubah file Google Spreadsheet (misalnya, dengan menambahkan baris, yang dihitung sebagai perubahan, bukan edit).
`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 yang diizinkan Apps Script yang dapat dieksekusi 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 bagaimana skrip diinstal kepada pengguna sebagai add-on.
`TriggerSource`	`TriggerSource`	Enumerasi yang menunjukkan sumber peristiwa yang menyebabkan pemicu diaktifkan.
`WeekDay`	`Weekday`	Enumerasi yang mewakili 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 digunakan untuk menentukan apakah pengguna perlu memberikan otorisasi pada skrip ini untuk menggunakan satu atau beberapa layanan, dan memberikan URL untuk dialog otorisasi.
`getIdentityToken()`	`String`	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 yang ditentukan, untuk skrip ini atau add-on saja.
`getUserTriggers(form)`	`Trigger[]`	Mendapatkan semua pemicu yang dapat diinstal yang dimiliki oleh pengguna ini dalam bentuk tertentu, untuk skrip atau add-on ini saja.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Mendapatkan semua pemicu penginstalan yang dimiliki oleh pengguna ini di spreadsheet yang ditentukan, untuk skrip ini atau add-on saja.
`invalidateAuth()`	`void`	Membatalkan otorisasi yang dimiliki pengguna efektif untuk mengeksekusi skrip saat ini.
`newStateToken()`	`StateTokenBuilder`	Membuat builder untuk token status yang dapat digunakan di callback API (seperti alur OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	Memulai proses pembuatan pemicu yang dapat diinstal yang, saat diaktifkan, akan memanggil fungsi tertentu.

`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 pemicu tersebut.
`onOpen()`	`SpreadsheetTriggerBuilder`	Menentukan pemicu yang akan diaktifkan saat spreadsheet dibuka.

`StateTokenBuilder`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`createToken()`	`String`	Membuat 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) saat token valid.

`Trigger`

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getEventType()`	`EventType`	Menampilkan jenis peristiwa yang diaktifkan oleh 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 pengidentifikasi 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 tertentu.
`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 yang diberikan.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Membuat dan menampilkan `SpreadsheetTriggerBuilder` yang terikat ke 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 berbasis waktu menyebabkan pemicu diaktifkan.
`FORMS`	`Enum`	Google Formulir menyebabkan pemicu diaktifkan.
`DOCUMENTS`	`Enum`	Google Dokumen menyebabkan pemicu diaktifkan.
`CALENDAR`	`Enum`	Google Kalender akan mengaktifkan pemicu.

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 2023-12-01 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