Halaman ini diterjemahkan oleh Cloud Translation API.

Class FormApp

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

CheckboxGridValidationBuilder

`createCheckboxValidation()`

Menampilkan instance CheckboxValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxItem.

Return

CheckboxValidationBuilder

`createFeedback()`

Menampilkan instance QuizFeedbackBuilder yang dapat digunakan untuk menetapkan masukan pada Item yang dapat dinilai.

Return

QuizFeedbackBuilder

`createGridValidation()`

Menampilkan instance GridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada GridItem.

Return

GridValidationBuilder

`createParagraphTextValidation()`

Menampilkan instance ParagraphTextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada ParagraphTextItem.

Return

ParagraphTextValidationBuilder

`createTextValidation()`

Menampilkan instance TextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada TextItem.

Return

TextValidationBuilder

`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