Script Service

Script

Layanan ini memberikan akses ke pemicu skrip dan publikasi skrip.

Class

NamaDeskripsi singkat
AuthModeEnumerasi yang mengidentifikasi kategori layanan yang diizinkan Apps Script yang dapat dieksekusi melalui fungsi yang dipicu.
AuthorizationInfoObjek yang digunakan untuk menentukan apakah pengguna perlu memberikan otorisasi pada skrip ini untuk menggunakan satu atau beberapa layanan, dan memberikan URL untuk dialog otorisasi.
AuthorizationStatusEnumerasi yang menunjukkan status otorisasi skrip.
CalendarTriggerBuilderBuilder untuk pemicu kalender.
ClockTriggerBuilderBuilder untuk pemicu jam.
DocumentTriggerBuilderBuilder untuk pemicu dokumen.
EventTypeEnumerasi yang menunjukkan jenis peristiwa yang dipicu.
FormTriggerBuilderBuilder untuk pemicu formulir.
InstallationSourceEnumerasi yang menunjukkan bagaimana skrip diinstal sebagai add-on untuk pengguna saat ini.
ScriptAppMengakses dan memanipulasi publikasi skrip dan pemicu.
ServiceMengakses dan memanipulasi publikasi skrip.
SpreadsheetTriggerBuilderBuilder untuk pemicu spreadsheet.
StateTokenBuilderMengizinkan skrip untuk membuat token status yang dapat digunakan di callback API (seperti alur OAuth).
TriggerPemicu skrip.
TriggerBuilderBuilder generik untuk pemicu skrip.
TriggerSourceEnumerasi yang menunjukkan sumber peristiwa yang menyebabkan pemicu diaktifkan.

AuthMode

Properti

PropertiJenisDeskripsi
NONEEnumMode yang tidak mengizinkan akses ke layanan apa pun yang memerlukan otorisasi.
CUSTOM_FUNCTIONEnumMode yang memungkinkan akses ke subset layanan terbatas untuk digunakan dalam fungsi spreadsheet kustom.
LIMITEDEnumMode yang memungkinkan akses ke {i>subset<i} layanan yang terbatas.
FULLEnumMode yang memungkinkan akses ke semua layanan yang memerlukan otorisasi.

AuthorizationInfo

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getAuthorizationStatus()AuthorizationStatusMendapatkan nilai yang menunjukkan apakah pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringMendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip.

AuthorizationStatus

Properti

PropertiJenisDeskripsi
REQUIREDEnumPengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan.
NOT_REQUIREDEnumPengguna telah memberikan semua otorisasi yang diperlukan untuk skrip ini.

CalendarTriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
create()TriggerMembuat pemicu dan menampilkannya.
onEventUpdated()CalendarTriggerBuilderMenentukan pemicu yang diaktifkan saat entri kalender dibuat, diperbarui, atau dihapus.

ClockTriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
after(durationMilliseconds)ClockTriggerBuilderMenentukan durasi minimum (dalam milidetik) setelah waktu saat pemicu berjalan.
at(date)ClockTriggerBuilderMenentukan kapan pemicu berjalan.
atDate(year, month, day)ClockTriggerBuilderMenentukan bahwa pemicu diaktifkan pada tanggal yang ditentukan, secara default mendekati tengah malam (+/- 15 menit).
atHour(hour)ClockTriggerBuilderMenentukan jam saat pemicu berjalan.
create()TriggerMembuat pemicu.
everyDays(n)ClockTriggerBuilderMendefinisikan untuk menjalankan pemicu setiap n hari.
everyHours(n)ClockTriggerBuilderMenyatakan agar pemicu dijalankan setiap n jam.
everyMinutes(n)ClockTriggerBuilderMenyatakan untuk menjalankan pemicu setiap n menit.
everyWeeks(n)ClockTriggerBuilderMenentukan untuk menjalankan pemicu setiap n minggu.
inTimezone(timezone)ClockTriggerBuilderMenentukan zona waktu untuk tanggal/waktu yang ditentukan saat pemicu berjalan.
nearMinute(minute)ClockTriggerBuilderMenentukan menit saat pemicu berjalan (plus atau minus 15 menit).
onMonthDay(day)ClockTriggerBuilderMenentukan tanggal dalam bulan saat pemicu berjalan.
onWeekDay(day)ClockTriggerBuilderMenentukan hari dalam seminggu saat pemicu berjalan.

DocumentTriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
create()TriggerMembuat dan menampilkan pemicu baru.
onOpen()DocumentTriggerBuilderMenentukan pemicu yang akan diaktifkan saat dokumen dibuka.

EventType

Properti

PropertiJenisDeskripsi
CLOCKEnumPemicu diaktifkan setelah peristiwa berbasis waktu mencapai waktu tertentu.
ON_OPENEnumPemicu diaktifkan setelah pengguna membuka file Google Dokumen, Spreadsheet, atau Formulir.
ON_EDITEnumPemicu diaktifkan setelah pengguna mengedit file Google Spreadsheet (misalnya, dengan memasukkan nilai baru ke dalam sel, yang dihitung sebagai edit, bukan perubahan).
ON_FORM_SUBMITEnumPemicu diaktifkan setelah pengguna merespons Formulir Google.
ON_CHANGEEnumPemicu diaktifkan setelah pengguna mengubah file Google Spreadsheet (misalnya, dengan menambahkan baris, yang dihitung sebagai perubahan, bukan edit).
ON_EVENT_UPDATEDEnumPemicu diaktifkan setelah acara dibuat, diperbarui, atau dihapus di Google Kalender yang ditentukan.

FormTriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
create()TriggerMembuat dan menampilkan pemicu baru.
onFormSubmit()FormTriggerBuilderMenentukan pemicu yang akan diaktifkan saat respons dikirimkan ke formulir.
onOpen()FormTriggerBuilderMenentukan pemicu yang akan diaktifkan saat tampilan edit formulir dibuka.

InstallationSource

Properti

PropertiJenisDeskripsi
APPS_MARKETPLACE_DOMAIN_ADD_ONEnumAdd-on diinstal oleh administrator untuk domain pengguna.
NONEEnumSkrip tidak berjalan sebagai add-on.
WEB_STORE_ADD_ONEnumAdd-on diinstal oleh pengguna dari Chrome Web Store.

ScriptApp

Properti

PropertiJenisDeskripsi
AuthModeAuthModeEnumerasi yang mengidentifikasi kategori layanan yang diizinkan Apps Script yang dapat dieksekusi melalui fungsi yang dipicu.
AuthorizationStatusAuthorizationStatusEnumerasi yang menunjukkan status otorisasi skrip.
EventTypeEventTypeEnumerasi yang menunjukkan jenis peristiwa yang dipicu.
InstallationSourceInstallationSourceEnumerasi yang menunjukkan bagaimana skrip diinstal kepada pengguna sebagai add-on.
TriggerSourceTriggerSourceEnumerasi yang menunjukkan sumber peristiwa yang menyebabkan pemicu diaktifkan.
WeekDayWeekdayEnumerasi yang mewakili hari dalam seminggu.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
deleteTrigger(trigger)voidMenghapus pemicu tertentu sehingga tidak lagi berjalan.
getAuthorizationInfo(authMode)AuthorizationInfoMendapatkan 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()StringMendapatkan token identitas OpenID Connect untuk pengguna efektif, jika cakupan openid telah diberikan.
getInstallationSource()InstallationSourceMenampilkan 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()StringMendapatkan 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()StringMendapatkan ID unik project skrip.
getService()ServiceMendapatkan 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()voidMembatalkan otorisasi yang dimiliki pengguna efektif untuk mengeksekusi skrip saat ini.
newStateToken()StateTokenBuilderMembuat builder untuk token status yang dapat digunakan di callback API (seperti alur OAuth).
newTrigger(functionName)TriggerBuilderMemulai proses pembuatan pemicu yang dapat diinstal yang, saat diaktifkan, akan memanggil fungsi tertentu.

Service

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getUrl()StringMenampilkan URL aplikasi web, jika telah di-deploy; jika tidak, menampilkan null.
isEnabled()BooleanMenampilkan true jika skrip dapat diakses sebagai aplikasi web.

SpreadsheetTriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
create()TriggerMembuat pemicu dan menampilkannya.
onChange()SpreadsheetTriggerBuilderMenentukan pemicu yang akan diaktifkan saat konten atau struktur spreadsheet diubah.
onEdit()SpreadsheetTriggerBuilderMenentukan pemicu yang akan diaktifkan saat spreadsheet diedit.
onFormSubmit()SpreadsheetTriggerBuilderMenentukan pemicu yang akan diaktifkan saat spreadsheet memiliki formulir yang dikirimkan ke pemicu tersebut.
onOpen()SpreadsheetTriggerBuilderMenentukan pemicu yang akan diaktifkan saat spreadsheet dibuka.

StateTokenBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
createToken()StringMembuat representasi string terenkripsi dari token status.
withArgument(name, value)StateTokenBuilderMenambahkan argumen ke token.
withMethod(method)StateTokenBuilderMenetapkan fungsi callback.
withTimeout(seconds)StateTokenBuilderMenetapkan durasi (dalam detik) saat token valid.

Trigger

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getEventType()EventTypeMenampilkan jenis peristiwa yang diaktifkan oleh pemicu.
getHandlerFunction()StringMenampilkan fungsi yang akan dipanggil saat pemicu diaktifkan.
getTriggerSource()TriggerSourceMenampilkan sumber peristiwa yang akan menyebabkan pemicu diaktifkan.
getTriggerSourceId()StringMenampilkan ID khusus untuk sumber.
getUniqueId()StringMenampilkan pengidentifikasi unik yang dapat digunakan untuk membedakan pemicu satu sama lain.

TriggerBuilder

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
forDocument(document)DocumentTriggerBuilderMembuat dan menampilkan DocumentTriggerBuilder yang terkait dengan dokumen tertentu.
forDocument(key)DocumentTriggerBuilderMembuat dan menampilkan DocumentTriggerBuilder yang terkait dengan dokumen dengan ID yang diberikan.
forForm(form)FormTriggerBuilderMembuat dan menampilkan FormTriggerBuilder yang terkait dengan formulir tertentu.
forForm(key)FormTriggerBuilderMembuat dan menampilkan FormTriggerBuilder yang terkait dengan formulir dengan ID yang diberikan.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderMembuat dan menampilkan SpreadsheetTriggerBuilder yang terkait dengan spreadsheet yang diberikan.
forSpreadsheet(key)SpreadsheetTriggerBuilderMembuat dan menampilkan SpreadsheetTriggerBuilder yang terikat ke spreadsheet dengan ID yang diberikan.
forUserCalendar(emailId)CalendarTriggerBuilderMenampilkan builder untuk membuat pemicu kalender.
timeBased()ClockTriggerBuilderMembuat dan menampilkan ClockTriggerBuilder untuk membuat pemicu berbasis waktu.

TriggerSource

Properti

PropertiJenisDeskripsi
SPREADSHEETSEnumGoogle Spreadsheet menyebabkan pemicu diaktifkan.
CLOCKEnumPeristiwa berbasis waktu menyebabkan pemicu diaktifkan.
FORMSEnumGoogle Formulir menyebabkan pemicu diaktifkan.
DOCUMENTSEnumGoogle Dokumen menyebabkan pemicu diaktifkan.
CALENDAREnumGoogle Kalender akan mengaktifkan pemicu.