Class Form

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

Formulir yang berisi properti dan item secara keseluruhan. Properti mencakup judul, setelan, dan tempat respons disimpan. Item mencakup item pertanyaan seperti kotak centang atau item radio, sedangkan item tata letak merujuk pada hal-hal seperti batas halaman. Formulir dapat diakses atau dibuat dari FormApp.

// Open a form by ID and create a new spreadsheet.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var ss = SpreadsheetApp.create('Spreadsheet Name');

// Update form properties via chaining.
form.setTitle('Form Name')
    .setDescription('Description of form')
    .setConfirmationMessage('Thanks for responding!')
    .setAllowResponseEdits(true)
    .setAcceptingResponses(false);

// Update the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addCheckboxGridItem()CheckboxGridItemMenambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang.
addCheckboxItem()CheckboxItemMenambahkan item pertanyaan baru yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya&quot opsional.
addDateItem()DateItemMenambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal.
addDateTimeItem()DateTimeItemMenambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal dan waktu.
addDurationItem()DurationItemMenambahkan item pertanyaan baru yang memungkinkan responden menunjukkan durasi waktu.
addEditor(emailAddress)FormMenambahkan pengguna yang ditentukan ke daftar editor untuk Form.
addEditor(user)FormMenambahkan pengguna yang ditentukan ke daftar editor untuk Form.
addEditors(emailAddresses)FormMenambahkan array pengguna yang ditentukan ke daftar editor untuk Form.
addGridItem()GridItemMenambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan.
addImageItem()ImageItemMenambahkan item tata letak baru yang menampilkan gambar.
addListItem()ListItemMenambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari menu drop-down.
addMultipleChoiceItem()MultipleChoiceItemMenambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar tombol pilihan atau kolom "lainnya&quot opsional.
addPageBreakItem()PageBreakItemMenambahkan item tata letak baru yang menandai awal halaman.
addParagraphTextItem()ParagraphTextItemMenambahkan item pertanyaan baru yang memungkinkan responden memasukkan blok teks.
addScaleItem()ScaleItemMenambahkan item pertanyaan baru yang memungkinkan responden memilih satu opsi dari urutan tombol radio bernomor.
addSectionHeaderItem()SectionHeaderItemMenambahkan item tata letak baru yang secara visual menunjukkan awal bagian.
addTextItem()TextItemMenambahkan item pertanyaan baru yang memungkinkan responden memasukkan satu baris teks.
addTimeItem()TimeItemMenambahkan item pertanyaan baru yang memungkinkan responden menunjukkan waktu dalam sehari.
addVideoItem()VideoItemMenambahkan item tata letak baru yang menampilkan video.
canEditResponse()BooleanMenentukan apakah formulir menampilkan link untuk mengedit respons setelah mengirimkannya.
collectsEmail()BooleanMenentukan apakah formulir mengumpulkan alamat email responden atau tidak.
createResponse()FormResponseMembuat respons baru untuk formulir.
deleteAllResponses()FormMenghapus semua respons yang dikirim dari penyimpanan respons formulir.
deleteItem(index)voidMenghapus item pada indeks tertentu di antara semua item yang ada dalam formulir.
deleteItem(item)voidMenghapus item tertentu.
deleteResponse(responseId)FormMenghapus satu respons dari penyimpanan respons formulir.
getConfirmationMessage()StringMendapatkan pesan konfirmasi formulir.
getCustomClosedFormMessage()StringMendapatkan pesan kustom yang akan ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan.
getDescription()StringMendapatkan deskripsi formulir.
getDestinationId()StringMendapatkan ID tujuan respons formulir.
getDestinationType()DestinationTypeMendapatkan jenis tujuan respons formulir.
getEditUrl()StringMendapatkan URL yang dapat digunakan untuk mengakses mode edit formulir.
getEditors()User[]Mendapatkan daftar editor untuk Form ini.
getId()StringMendapatkan ID formulir.
getItemById(id)ItemMendapatkan item dengan ID tertentu.
getItems()Item[]Mendapatkan array dari semua item dalam formulir.
getItems(itemType)Item[]Mendapatkan array dari semua item dari jenis tertentu.
getPublishedUrl()StringMendapatkan URL yang dapat digunakan untuk merespons formulir.
getResponse(responseId)FormResponseMendapatkan satu respons formulir berdasarkan ID responsnya.
getResponses()FormResponse[]Mendapatkan array dari semua respons formulir.
getResponses(timestamp)FormResponse[]Mendapatkan array dari semua respons formulir setelah tanggal dan waktu tertentu.
getShuffleQuestions()BooleanMenentukan apakah urutan pertanyaan di setiap halaman formulir diacak.
getSummaryUrl()StringMendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir.
getTitle()StringMendapatkan judul formulir.
hasLimitOneResponsePerUser()BooleanMenentukan apakah formulir hanya mengizinkan satu respons per responden.
hasProgressBar()BooleanMenentukan apakah formulir menampilkan status progres.
hasRespondAgainLink()BooleanMenentukan apakah formulir menampilkan link untuk mengirim respons lain setelah responden melengkapi formulir.
isAcceptingResponses()BooleanMenentukan apakah formulir saat ini menerima respons.
isPublishingSummary()BooleanMenentukan apakah formulir menampilkan link untuk melihat ringkasan respons setelah responden melengkapi formulir.
isQuiz()BooleanMenentukan apakah formulir merupakan kuis.
moveItem(from, to)ItemMemindahkan item pada indeks tertentu di antara semua item yang ada dalam formulir ke indeks tertentu lainnya.
moveItem(item, toIndex)ItemMemindahkan item tertentu ke indeks tertentu di antara semua item yang ada dalam formulir.
removeDestination()FormMembatalkan tautan formulir dari tujuan responsnya saat ini.
removeEditor(emailAddress)FormMenghapus pengguna yang ditentukan dari daftar editor untuk Form.
removeEditor(user)FormMenghapus pengguna yang ditentukan dari daftar editor untuk Form.
requiresLogin()BooleanMenentukan apakah formulir mengharuskan responden untuk login ke akun dalam domain atau subdomain yang sama sebelum memberikan respons.
setAcceptingResponses(enabled)FormMenetapkan apakah formulir saat ini menerima respons.
setAllowResponseEdits(enabled)FormMenetapkan apakah formulir menampilkan link untuk mengedit respons setelah mengirimkannya.
setCollectEmail(collect)FormMenetapkan apakah formulir mengumpulkan alamat email responden.
setConfirmationMessage(message)FormMenyetel pesan konfirmasi formulir.
setCustomClosedFormMessage(message)FormMenetapkan pesan yang akan ditampilkan jika formulir tidak menerima respons.
setDescription(description)FormMenyetel deskripsi formulir.
setDestination(type, id)FormMenetapkan tujuan tempat respons formulir disimpan.
setIsQuiz(enabled)FormMenetapkan apakah formulir merupakan kuis.
setLimitOneResponsePerUser(enabled)FormMenetapkan apakah formulir hanya mengizinkan satu respons per responden.
setProgressBar(enabled)FormMenetapkan apakah formulir memiliki status progres.
setPublishingSummary(enabled)FormMenetapkan apakah formulir menampilkan link untuk melihat ringkasan respons setelah responden mengirimkan formulir.
setRequireLogin(requireLogin)FormMenetapkan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum memberikan respons.
setShowLinkToRespondAgain(enabled)FormMenetapkan apakah formulir menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir.
setShuffleQuestions(shuffle)FormMenetapkan apakah urutan pertanyaan di setiap halaman formulir diacak.
setTitle(title)FormMenetapkan judul formulir.
shortenFormUrl(url)StringMengonversi URL panjang untuk formulir menjadi URL singkat.
submitGrades(responses)FormMengirim nilai untuk FormResponses tertentu.

Dokumentasi mendetail

addCheckboxGridItem()

Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang.

Return

CheckboxGridItem — item yang baru dibuat

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

addCheckboxItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya&quot opsional.

Return

CheckboxItem — item yang baru dibuat

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

addDateItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal.

Return

DateItem — item yang baru dibuat

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

addDateTimeItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal dan waktu.

Return

DateTimeItem — item yang baru dibuat

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

addDurationItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan durasi waktu.

Return

DurationItem — item yang baru dibuat

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

addEditor(emailAddress)

Menambahkan pengguna yang ditentukan ke daftar editor untuk Form. Jika pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan pengguna tersebut dari daftar audiens.

Parameter

NameJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Return

Form — Ini Form, untuk rantai.

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

addEditor(user)

Menambahkan pengguna yang ditentukan ke daftar editor untuk Form. Jika pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan pengguna tersebut dari daftar audiens.

Parameter

NameJenisDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Return

Form — Ini Form, untuk rantai.

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

addEditors(emailAddresses)

Menambahkan array pengguna yang ditentukan ke daftar editor untuk Form. Jika salah satu pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan mereka dari daftar audiens.

Parameter

NameJenisDeskripsi
emailAddressesString[]Array alamat email pengguna yang akan ditambahkan.

Return

Form — Ini Form, untuk rantai.

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

addGridItem()

Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan.

Return

GridItem — item yang baru dibuat

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

addImageItem()

Menambahkan item tata letak baru yang menampilkan gambar.

Return

ImageItem — item yang baru dibuat

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

addListItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari menu drop-down.

Return

ListItem — item yang baru dibuat

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

addMultipleChoiceItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar tombol pilihan atau kolom "lainnya&quot opsional.

Return

MultipleChoiceItem — item yang baru dibuat

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

addPageBreakItem()

Menambahkan item tata letak baru yang menandai awal halaman.

Return

PageBreakItem — item yang baru dibuat

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

addParagraphTextItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan blok teks.

Return

ParagraphTextItem — item yang baru dibuat

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

addScaleItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu opsi dari urutan tombol radio bernomor.

Return

ScaleItem — item yang baru dibuat

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

addSectionHeaderItem()

Menambahkan item tata letak baru yang secara visual menunjukkan awal bagian.

Return

SectionHeaderItem — item yang baru dibuat

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

addTextItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan satu baris teks.

Return

TextItem — item yang baru dibuat

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

addTimeItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan waktu dalam sehari.

Return

TimeItem — item yang baru dibuat

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

addVideoItem()

Menambahkan item tata letak baru yang menampilkan video.

Return

VideoItem — item yang baru dibuat

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

canEditResponse()

Menentukan apakah formulir menampilkan link untuk mengedit respons setelah mengirimkannya.

Terlepas dari setelan ini, metode FormResponse.getEditResponseUrl() memungkinkan penulis skrip yang memiliki akses edit ke formulir untuk membuat URL yang dapat digunakan untuk mengedit respons.

Return

Booleantrue jika formulir menampilkan "Edit respons" link; false jika tidak

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

collectsEmail()

Menentukan apakah formulir mengumpulkan alamat email responden atau tidak.

Return

Booleantrue jika formulir mengumpulkan alamat email; false jika tidak

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

createResponse()

Membuat respons baru untuk formulir. Untuk menjawab item pertanyaan, buat ItemResponse dari item tersebut, lalu lampirkan ke respons formulir ini dengan memanggil FormResponse.withItemResponse(response). Untuk menyimpan respons tersusun, panggil FormResponse.submit().

Return

FormResponse — respons formulir yang baru dibuat

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

deleteAllResponses()

Menghapus semua respons yang dikirim dari penyimpanan respons formulir. Metode ini tidak menghapus salinan respons yang disimpan di tujuan respons eksternal (seperti spreadsheet), tetapi menghapus tampilan ringkasan formulir.

Return

Form — ini Form, untuk rantai

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

deleteItem(index)

Menghapus item pada indeks tertentu di antara semua item yang ada dalam formulir. Menampilkan pengecualian skrip jika tidak ada item pada indeks tertentu.

Parameter

NameJenisDeskripsi
indexIntegerindeks item di antara semua item yang ada dalam formulir

Menampilkan

Error — jika tidak ada item pada indeks tertentu

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

deleteItem(item)

Menghapus item tertentu. Melempar pengecualian skrip jika item telah dihapus.

Parameter

NameJenisDeskripsi
itemItemitem yang akan dihapus

Menampilkan

Error — jika item tidak ada dalam 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

deleteResponse(responseId)

Menghapus satu respons dari penyimpanan respons formulir. Metode ini tidak menghapus salinan respons yang disimpan di tujuan respons eksternal (seperti spreadsheet), tetapi menghapus respons dari tampilan ringkasan formulir. ID respons dapat diambil dengan FormResponse.getId().

Parameter

NameJenisDeskripsi
responseIdStringID respons formulir yang akan dihapus

Return

Form — ini Form, untuk rantai

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

getConfirmationMessage()

Mendapatkan pesan konfirmasi formulir.

Return

String — pesan konfirmasi 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

getCustomClosedFormMessage()

Mendapatkan pesan kustom yang akan ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan.

Return

String — pesan kustom yang akan ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan

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

getDescription()

Mendapatkan deskripsi formulir.

Return

String — deskripsi 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

getDestinationId()

Mendapatkan ID tujuan respons formulir.

Return

String — ID tujuan respons 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

getDestinationType()

Mendapatkan jenis tujuan respons formulir.

Return

DestinationType — jenis tujuan respons 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

getEditUrl()

Mendapatkan URL yang dapat digunakan untuk mengakses mode edit formulir.

Return

String — URL untuk mengedit 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

getEditors()

Mendapatkan daftar editor untuk Form ini.

Return

User[] — Array pengguna dengan izin edit.

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

getId()

Mendapatkan ID formulir.

Return

String — ID 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

getItemById(id)

Mendapatkan item dengan ID tertentu. Menampilkan null jika ID tidak sesuai dengan item dalam formulir.

Parameter

NameJenisDeskripsi
idIntegerID item

Return

Item — item dengan ID yang diberikan, atau null jika item tidak ada dalam 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

getItems()

Mendapatkan array dari semua item dalam formulir.

Return

Item[] — array semua item dalam 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

getItems(itemType)

Mendapatkan array dari semua item dari jenis tertentu.

Parameter

NameJenisDeskripsi
itemTypeItemTypejenis item yang akan diambil

Return

Item[] — array semua item dari jenis tersebut

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

getPublishedUrl()

Mendapatkan URL yang dapat digunakan untuk merespons formulir.

Return

String — URL untuk merespons 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

getResponse(responseId)

Mendapatkan satu respons formulir berdasarkan ID responsnya. ID respons dapat diambil dari FormResponse.getId().

Parameter

NameJenisDeskripsi
responseIdStringID untuk respons formulir

Return

FormResponse — respons formulir

Menampilkan

Error — jika respons tidak ada

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

getResponses()

Mendapatkan array dari semua respons formulir.

Return

FormResponse[] — array dari semua respons 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

getResponses(timestamp)

Mendapatkan array dari semua respons formulir setelah tanggal dan waktu tertentu.

Parameter

NameJenisDeskripsi
timestampDatetanggal dan waktu paling awal saat respons formulir harus ditampilkan

Return

FormResponse[] — daftar respons 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

getShuffleQuestions()

Menentukan apakah urutan pertanyaan di setiap halaman formulir diacak.

Return

Booleantrue jika urutan pertanyaan di setiap halaman formulir diacak; false jika tidak

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

getSummaryUrl()

Mendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir. Hanya setPublishingSummary(enabled) yang ditetapkan ke true, hanya pengguna dengan izin edit ke formulir yang dapat mengakses URL.

Return

String — URL untuk melihat ringkasan respons

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

getTitle()

Mendapatkan judul formulir.

Return

String — judul 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

hasLimitOneResponsePerUser()

Menentukan apakah formulir hanya mengizinkan satu respons per responden. Jika nilainya true, skrip tidak dapat mengirimkan respons formulir sama sekali.

Return

Booleantrue jika formulir hanya mengizinkan satu respons per responden; false jika tidak

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

hasProgressBar()

Menentukan apakah formulir menampilkan status progres.

Return

Booleantrue jika formulir menampilkan status progres; false jika tidak

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

Menentukan apakah formulir menampilkan link untuk mengirim respons lain setelah responden melengkapi formulir.

Return

Booleantrue jika formulir menampilkan "Kirim respons lain" link; false jika tidak

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

isAcceptingResponses()

Menentukan apakah formulir saat ini menerima respons.

Return

Booleantrue jika formulir menerima respons; false jika tidak

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

isPublishingSummary()

Menentukan apakah formulir menampilkan link untuk melihat ringkasan respons setelah responden melengkapi formulir.

Return

Booleantrue jika formulir menampilkan "Lihat respons sebelumnya" link; false jika tidak

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

isQuiz()

Menentukan apakah formulir merupakan kuis.

Return

Booleantrue jika formulir menerima respons; false jika tidak

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

moveItem(from, to)

Memindahkan item pada indeks tertentu di antara semua item yang ada dalam formulir ke indeks tertentu lainnya. Menampilkan pengecualian skrip jika indeks to di luar batas.

Parameter

NameJenisDeskripsi
fromIntegerindeks item saat ini di antara semua item yang ada dalam formulir
toIntegerindeks baru untuk item di antara semua item yang ada dalam formulir

Return

Item — item yang dipindahkan

Menampilkan

Error — jika salah satu indeks berada di luar batas

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

moveItem(item, toIndex)

Memindahkan item tertentu ke indeks tertentu di antara semua item yang ada dalam formulir. Menampilkan pengecualian skrip jika indeks tertentu berada di luar batas.

Parameter

NameJenisDeskripsi
itemItemitem yang akan dipindahkan
toIndexIntegerindeks baru untuk item di antara semua item yang ada dalam formulir

Return

Item — item yang dipindahkan

Menampilkan

Error — jika indeks berada di luar batas

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

removeDestination()

Membatalkan tautan formulir dari tujuan responsnya saat ini. Bekas tujuan yang dibatalkan tautannya masih mempertahankan salinan semua respons sebelumnya. Semua formulir, termasuk yang tidak memiliki tujuan yang ditetapkan secara eksplisit, menyimpan salinan respons di penyimpanan respons formulir. Jika formulir saat ini tidak memiliki tujuan respons, metode ini tidak akan berpengaruh.

Return

Form — ini Form, untuk rantai

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

removeEditor(emailAddress)

Menghapus pengguna yang ditentukan dari daftar editor untuk Form. Metode ini tidak memblokir pengguna agar tidak dapat mengakses Form jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Form dibagikan kepada seluruh domain pengguna, atau jika Form berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, pengguna juga akan dihapus dari daftar pengakses lihat-saja.

Parameter

NameJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Return

Form — Ini Form, untuk rantai.

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

removeEditor(user)

Menghapus pengguna yang ditentukan dari daftar editor untuk Form. Metode ini tidak memblokir pengguna agar tidak dapat mengakses Form jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Form dibagikan kepada seluruh domain pengguna, atau jika Form berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, pengguna juga akan dihapus dari daftar pengakses lihat-saja.

Parameter

NameJenisDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Return

Form — Ini Form, untuk rantai.

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

requiresLogin()

Menentukan apakah formulir mengharuskan responden untuk login ke akun dalam domain atau subdomain yang sama sebelum memberikan respons.

Return

Booleantrue jika formulir mengharuskan pengguna untuk login; false jika tidak


setAcceptingResponses(enabled)

Menetapkan apakah formulir saat ini menerima respons. Default untuk formulir baru adalah true.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir harus menerima respons; false jika tidak

Return

Form — ini Form, untuk rantai

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

setAllowResponseEdits(enabled)

Menetapkan apakah formulir menampilkan link untuk mengedit respons setelah mengirimkannya. Default untuk formulir baru adalah false.

Terlepas dari setelan ini, metode FormResponse.getEditResponseUrl() memungkinkan penulis skrip yang memiliki izin edit ke formulir untuk membuat URL yang dapat digunakan untuk mengedit respons.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir seharusnya menampilkan "Edit respons" link; false jika tidak

Return

Form — ini Form, untuk rantai

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

setCollectEmail(collect)

Menetapkan apakah formulir mengumpulkan alamat email responden. Default untuk formulir baru adalah false.

Parameter

NameJenisDeskripsi
collectBooleantrue jika formulir harus mengumpulkan alamat email; false jika tidak

Return

Form — ini Form, untuk rantai

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

setConfirmationMessage(message)

Menyetel pesan konfirmasi formulir.

Parameter

NameJenisDeskripsi
messageStringpesan konfirmasi baru formulir

Return

Form — ini Form, untuk rantai

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

setCustomClosedFormMessage(message)

Menetapkan pesan yang akan ditampilkan jika formulir tidak menerima respons. Jika tidak ada pesan yang ditetapkan, formulir akan menggunakan pesan default.

Parameter

NameJenisDeskripsi
messageStringpesan yang akan ditampilkan jika formulir tidak menerima respons

Return

Form — ini Form, untuk rantai

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

setDescription(description)

Menyetel deskripsi formulir.

Parameter

NameJenisDeskripsi
descriptionStringdeskripsi baru formulir

Return

Form — ini Form, untuk rantai

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

setDestination(type, id)

Menetapkan tujuan tempat respons formulir disimpan. Semua formulir, termasuk yang tidak memiliki tujuan yang ditetapkan secara eksplisit, menyimpan salinan respons di penyimpanan respons formulir.

Parameter

NameJenisDeskripsi
typeDestinationTypejenis tujuan tanggapan formulir
idStringID tujuan respons formulir

Return

Form — ini Form, untuk rantai

Menampilkan

Error — jika ID tujuan yang diberikan tidak valid

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

setIsQuiz(enabled)

Menetapkan apakah formulir merupakan kuis. Default untuk formulir baru adalah false.

Pertanyaan yang dinilai hanya diizinkan di Kuis, sehingga menetapkan nilai ini ke salah akan menyebabkan semua opsi penilaian dihapus dari semua pertanyaan.

Setelan kuis hanya tersedia di UI Formulir yang baru; membuat formulir sebagai Kuis akan memilih formulir untuk menggunakan UI yang baru.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika fitur kuis harus diaktifkan untuk formulir; false jika tidak

Return

Form — ini Form, untuk rantai

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

setLimitOneResponsePerUser(enabled)

Menetapkan apakah formulir hanya mengizinkan satu respons per responden. Default untuk formulir baru adalah false. Jika nilai ditetapkan ke true, skrip tidak dapat mengirimkan respons formulir sama sekali.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir hanya mengizinkan satu respons per responden; false jika tidak

Return

Form — ini Form, untuk rantai

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

setProgressBar(enabled)

Menetapkan apakah formulir memiliki status progres. Default untuk formulir baru adalah false.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir akan menampilkan status progres; false jika tidak

Return

Form — ini Form, untuk rantai

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

setPublishingSummary(enabled)

Menetapkan apakah formulir menampilkan link untuk melihat ringkasan respons setelah responden mengirimkan formulir. Default untuk formulir baru adalah false.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir seharusnya menampilkan "Lihat respons sebelumnya" link; false jika tidak

Return

Form — ini Form, untuk rantai

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

setRequireLogin(requireLogin)

Menetapkan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum memberikan respons. Default untuk formulir baru adalah false kecuali jika administrator domain mengubah setelan default.

Fitur ini hanya tersedia untuk formulir yang dibuat oleh pengguna Google Workspace. Pengguna jenis Akun Google lainnya tidak boleh diwajibkan untuk login.

Parameter

NameJenisDeskripsi
requireLoginBooleantrue jika formulir mengharuskan pengguna untuk login; false jika tidak

Return

Form — bentuk saat ini (untuk jaringan)

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

setShowLinkToRespondAgain(enabled)

Menetapkan apakah formulir menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir. Default untuk formulir baru adalah true.

Parameter

NameJenisDeskripsi
enabledBooleantrue jika formulir seharusnya menampilkan "Kirim tanggapan lain" link; false jika tidak

Return

Form — ini Form, untuk rantai

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

setShuffleQuestions(shuffle)

Menetapkan apakah urutan pertanyaan di setiap halaman formulir diacak.

Parameter

NameJenisDeskripsi
shuffleBooleantrue jika urutan pertanyaan pada setiap halaman dalam formulir harus diacak; false jika tidak

Return

Form — ini Form, untuk rantai

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

setTitle(title)

Menetapkan judul formulir.

Parameter

NameJenisDeskripsi
titleStringjudul baru formulir

Return

Form — ini Form, untuk rantai

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

shortenFormUrl(url)

Mengonversi URL panjang untuk formulir menjadi URL singkat. Melempar pengecualian jika URL panjang tidak termasuk di Google Formulir.

Parameter

NameJenisDeskripsi
urlString

Return

String — URL dalam bentuk http://goo.gl/forms/1234

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

submitGrades(responses)

Mengirim nilai untuk FormResponses tertentu.

Jika kode Anda menyertakan pemicu onFormSubmit, memanggil submitGrades() akan memicu kondisi onFormSubmit dan menyebabkan loop tak terbatas. Untuk mencegah loop tak terbatas, tambahkan kode yang memeriksa apakah nilai sudah ada sebelum memanggil submitGrades().

Parameter

NameJenisDeskripsi
responsesFormResponse[]

Return

Form — Ini Form, untuk rantai.

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