Halaman ini diterjemahkan oleh Cloud Translation API.

Class FormApp

Izinkan skrip untuk membuka Form yang 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 menyetel validasi pada `CheckboxItem`.
`createFeedback()`	`QuizFeedbackBuilder`	Menampilkan instance QuizFeedbackBuilder yang dapat digunakan untuk menetapkan masukan pada respons yang dapat dinilai `Item`.
`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 yang skripnya terikat container.
`getUi()`	`Ui`	Menampilkan instance lingkungan antarmuka pengguna editor formulir yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan bilah sisi.
`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

Pulang pergi

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.

Pulang pergi

CheckboxGridValidationBuilder

`createCheckboxValidation()`

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

Pulang pergi

CheckboxValidationBuilder

`createFeedback()`

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

Pulang pergi

QuizFeedbackBuilder

`createGridValidation()`

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

Pulang pergi

GridValidationBuilder

`createParagraphTextValidation()`

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

Pulang pergi

ParagraphTextValidationBuilder

`createTextValidation()`

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

Pulang pergi

TextValidationBuilder

`getActiveForm()`

Menampilkan formulir yang skripnya terikat container. Untuk berinteraksi dengan formulir yang skrip tidak terikat pada container, gunakan openById(id) atau openByUrl(url) sebagai gantinya.

// Get the form to which this script is bound.
var form = FormApp.getActiveForm();

Pulang pergi

Form — bentuk yang digunakan 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 untuk menambahkan fitur seperti menu, dialog, dan bilah sisi. Skrip hanya dapat berinteraksi dengan UI untuk saat ini dari editor formulir terbuka (bukan tampilan yang dilihat responden), dan hanya jika skrip terikat ke formulir. Untuk selengkapnya informasi, 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();
}

Pulang pergi

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

Pulang pergi

Form — formulir dengan ID yang diberikan

Menampilkan

Error — jika ID yang diberikan tidak valid atau pengguna tidak memiliki izin

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 untuk membuka

Pulang pergi

Form — formulir dengan URL yang diberikan

Menampilkan

Error — jika URL yang diberikan tidak valid atau pengguna tidak memiliki izin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/forms