Halaman ini diterjemahkan oleh Cloud Translation API.

Class FormApp

Memungkinkan skrip membuka Form yang ada atau membuat yang baru.

// Open a form by ID.
const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
const 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.
`RatingIconType`	`RatingIconType`	Enumerasi jenis ikon rating `RatingIcons`

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 tempat skrip terikat penampung.
`getUi()`	`Ui`	Menampilkan instance lingkungan antarmuka pengguna editor formulir yang memungkinkan skrip untuk 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.
const 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 menetapkan validasi pada CheckboxItem.

Pulang pergi

CheckboxValidationBuilder

`createFeedback()`

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

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 tempat 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.
const form = FormApp.getActiveForm();

Pulang pergi

Form — formulir tempat skrip terikat, 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 sidebar. Skrip hanya dapat berinteraksi dengan UI untuk instance editor formulir terbuka saat ini (bukan tampilan yang dilihat responden), dan hanya jika skrip terikat ke formulir. Untuk 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();
}

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Parameter

Nama	Jenis	Deskripsi
`id`	`String`	ID formulir yang akan dibuka

Pulang pergi

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.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL formulir yang akan dibuka

Pulang pergi

Form — formulir dengan URL yang diberikan

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