Mengizinkan skrip untuk membuka Form
yang sudah ada atau membuat yang baru.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
Properti
Properti | Jenis | Deskripsi |
---|---|---|
Alignment | Alignment | Enumerasi jenis perataan gambar. |
DestinationType | DestinationType | Enumerasi jenis tujuan yang dapat menyimpan respons formulir. |
FeedbackType | FeedbackType | Enumerasi jenis formulir Feedbacks . |
ItemType | ItemType | Enumerasi jenis formulir Items . |
PageNavigationType | PageNavigationType | Enumerasi kemungkinan perilaku untuk menavigasi halaman. |
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
create(title) | Form | Membuat dan menampilkan Form baru. |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | Menampilkan instance CheckboxGridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | Menampilkan instance CheckboxValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | Menampilkan instance QuizFeedbackBuilder yang dapat digunakan untuk menetapkan masukan pada Item yang dapat dinilai. |
createGridValidation() | GridValidationBuilder | Menampilkan instance GridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | Menampilkan instance ParagraphTextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | Menampilkan instance TextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada TextItem . |
getActiveForm() | Form | Menampilkan formulir untuk skrip terikat penampung. |
getUi() | Ui | Menampilkan instance lingkungan antarmuka pengguna editor formulir yang memungkinkan skrip menambahkan fitur seperti menu, dialog, dan sidebar. |
openById(id) | Form | Menampilkan Form dengan ID yang ditentukan. |
openByUrl(url) | Form | Menampilkan Form dengan URL yang ditentukan. |
Dokumentasi mendetail
create(title)
Membuat dan menampilkan Form
baru. Menampilkan pengecualian jika judul yang diberikan adalah null
atau kosong.
// Create and open a form. var form = FormApp.create('Form Name');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
title | String | nama formulir baru |
Return
Form
— formulir baru
Menampilkan
Error
— jika judul yang diberikan adalah null
atau kosong
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
Menampilkan instance CheckboxGridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxGridItem
.
Return
createCheckboxValidation()
Menampilkan instance CheckboxValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxItem
.
Return
createFeedback()
Menampilkan instance QuizFeedbackBuilder yang dapat digunakan untuk menetapkan masukan pada Item
yang dapat dinilai.
Return
createGridValidation()
Menampilkan instance GridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada GridItem
.
Return
createParagraphTextValidation()
Menampilkan instance ParagraphTextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada ParagraphTextItem
.
Return
createTextValidation()
Menampilkan instance TextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada TextItem
.
Return
getActiveForm()
Menampilkan formulir untuk skrip terikat penampung. Untuk berinteraksi dengan formulir yang skripnya tidak terikat penampung, gunakan openById(id)
atau openByUrl(url)
.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
Return
Form
— bentuk yang mengikat skrip, atau null
jika skrip tidak terikat dengan formulir
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
Menampilkan instance lingkungan antarmuka pengguna editor formulir yang memungkinkan skrip menambahkan fitur seperti menu, dialog, dan sidebar. Skrip hanya dapat berinteraksi dengan UI untuk instance editor formulir terbuka saat ini (bukan tampilan yang dilihat responden), dan hanya jika skrip terikat dengan formulir tersebut. Untuk mengetahui informasi selengkapnya, lihat panduan untuk menu serta dialog dan sidebar.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Return
Ui
— instance lingkungan antarmuka pengguna formulir ini
openById(id)
Menampilkan Form
dengan ID yang ditentukan. Menampilkan pengecualian jika ID tidak valid atau
pengguna tidak memiliki izin untuk membuka formulir.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
id | String | ID formulir untuk membuka |
Return
Form
— formulir dengan ID yang diberikan
Menampilkan
Error
— jika ID yang diberikan tidak valid atau pengguna tidak memiliki izin
yang memadai
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
Menampilkan Form
dengan URL yang ditentukan. Menampilkan pengecualian jika URL tidak valid atau
pengguna tidak memiliki izin untuk membuka formulir.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | URL formulir yang akan dibuka |
Return
Form
— formulir dengan URL yang ditentukan
Menampilkan
Error
— jika URL yang diberikan tidak valid atau pengguna tidak memiliki izin
yang memadai
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/forms