Class FormApp

FormApp

Mengizinkan 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 nilai yang ditampilkan	Deskripsi singkat
create(title)	Form	Membuat dan menampilkan Form baru.
create(title, isPublished)	Form	Membuat dan menampilkan Form baru dalam status publikasi yang diminta.
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 menyetel 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 yang terikat ke penampung skrip.
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.
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

---

create(title, isPublished)

Membuat dan menampilkan Form baru dalam status publikasi yang diminta. Menampilkan pengecualian jika judul yang diberikan adalah null atau kosong.

// Create, publish and open a form.
const form = FormApp.create('Form Name', true);

Parameter

Nama	Jenis	Deskripsi
title	String	Nama formulir baru.
isPublished	Boolean	Apakah formulir harus dipublikasikan.

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 menyetel 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 yang terikat ke penampung skrip. Untuk berinteraksi dengan formulir yang tidak terikat ke skrip, gunakan openById(id) atau openByUrl(url) sebagai gantinya.

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

Pulang pergi

Form — formulir yang menjadi tujuan pengikatan skrip, atau null jika skrip tidak terikat ke 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 ke formulir. Untuk informasi selengkapnya, lihat panduan untuk menu dan 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