Class FormApp

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
FormulirAplikasi

Mengizinkan 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

PropertiJenisDeskripsi
AlignmentAlignmentEnumerasi jenis penyelarasan gambar.
DestinationTypeDestinationTypeEnumerasi jenis tujuan yang dapat menyimpan respons formulir.
FeedbackTypeFeedbackTypeEnumerasi jenis formulir Feedbacks.
ItemTypeItemTypeEnumerasi jenis formulir Items.
PageNavigationTypePageNavigationTypeEnumerasi kemungkinan perilaku untuk menavigasi halaman.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
create(title)FormMembuat dan menampilkan Form baru.
createCheckboxGridValidation()CheckboxGridValidationBuilderMenampilkan instance CheckboxGridValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderMenampilkan instance CheckboxValidationBuilder yang dapat digunakan untuk menetapkan validasi pada CheckboxItem.
createFeedback()QuizFeedbackBuilderMenampilkan instance QuizFeedbackBuilder yang dapat digunakan untuk menetapkan masukan pada Item yang dapat dinilai.
createGridValidation()GridValidationBuilderMenampilkan instance GridValidationBuilder yang dapat digunakan untuk menetapkan validasi di GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderMenampilkan instance ParagraphTextValidationBuilder yang dapat digunakan untuk menetapkan validasi pada ParagraphTextItem.
createTextValidation()TextValidationBuilderMenampilkan instance TextValidationBuilder yang dapat digunakan untuk menetapkan validasi di TextItem.
getActiveForm()FormMenampilkan formulir dengan skrip terikat penampung.
getUi()UiMenampilkan instance lingkungan antarmuka pengguna editor formulir yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan sidebar.
openById(id)FormMenampilkan Form dengan ID yang ditentukan.
openByUrl(url)FormMenampilkan Form dengan URL yang ditentukan.

Dokumentasi mendetail

create(title)

Membuat dan menampilkan Form baru. Melempar pengecualian jika judul yang diberikan null atau kosong.

// Create and open a form.
var form = FormApp.create('Form Name');

Parameter

NameJenisDeskripsi
titleStringnama 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 di 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 di TextItem.

Return

TextValidationBuilder


getActiveForm()

Menampilkan formulir dengan 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 — 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();
}

Return

Ui — instance lingkungan antarmuka pengguna formulir ini


openById(id)

Menampilkan Form dengan ID yang ditentukan. Melempar pengecualian jika ID tidak valid atau pengguna tidak memiliki izin untuk membuka formulir.

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

Parameter

NameJenisDeskripsi
idStringID formulir yang akan dibuka

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

NameJenisDeskripsi
urlStringURL 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