Item pertanyaan yang memungkinkan responden memilih satu pilihan dari daftar tombol pilihan atau
kolom "lainnya" opsional. Item dapat diakses atau dibuat dari Form
. Saat digunakan dalam
kuis, item ini dinilai secara otomatis.
// Open a form by ID and add a new multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
createChoice(value) | Choice | Membuat pilihan baru. |
createChoice(value, isCorrect) | Choice | Membuat pilihan baru. |
createChoice(value, navigationItem) | Choice | Membuat pilihan baru dengan opsi navigasi halaman yang melompat ke item batas halaman tertentu. |
createChoice(value, navigationType) | Choice | Membuat pilihan baru dengan opsi navigasi halaman. |
createResponse(response) | ItemResponse | Membuat ItemResponse baru untuk item pilihan ganda ini. |
duplicate() | MultipleChoiceItem | Membuat salinan item ini dan menambahkannya ke akhir formulir. |
getChoices() | Choice[] | Mendapatkan semua pilihan untuk sebuah item. |
getFeedbackForCorrect() | QuizFeedback | Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar. |
getFeedbackForIncorrect() | QuizFeedback | Menampilkan masukan yang ditampilkan kepada responden jika mereka salah menjawab pertanyaan. |
getHelpText() | String | Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems , PageBreakItems , dan SectionHeaderItems ). |
getId() | Integer | Mendapatkan ID unik item. |
getIndex() | Integer | Mendapatkan indeks item di antara semua item dalam formulir. |
getPoints() | Integer | Menampilkan nilai poin dari item yang dapat dinilai. |
getTitle() | String | Mendapatkan judul item (terkadang disebut teks header, untuk SectionHeaderItem ). |
getType() | ItemType | Mendapatkan jenis item, yang direpresentasikan sebagai ItemType . |
hasOtherOption() | Boolean | Menentukan apakah item memiliki opsi "lainnya". |
isRequired() | Boolean | Menentukan apakah responden harus menjawab pertanyaan atau tidak. |
setChoiceValues(values) | MultipleChoiceItem | Menetapkan pilihan untuk item dari array string. |
setChoices(choices) | MultipleChoiceItem | Menetapkan array pilihan untuk sebuah item. |
setFeedbackForCorrect(feedback) | MultipleChoiceItem | Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar. |
setFeedbackForIncorrect(feedback) | MultipleChoiceItem | Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan. |
setHelpText(text) | MultipleChoiceItem | Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems , PageBreakItems , dan SectionHeaderItems ). |
setPoints(points) | MultipleChoiceItem | Menetapkan jumlah poin untuk item yang dapat dinilai. |
setRequired(enabled) | MultipleChoiceItem | Menetapkan apakah responden harus menjawab pertanyaan. |
setTitle(title) | MultipleChoiceItem | Menetapkan judul item (terkadang disebut teks header, untuk SectionHeaderItem ). |
showOtherOption(enabled) | MultipleChoiceItem | Menetapkan apakah item memiliki opsi "quot;other". |
Dokumentasi mendetail
createChoice(value)
Membuat pilihan baru.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
value | String | nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir |
Return
Choice
— pilihan baru
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
createChoice(value, isCorrect)
Membuat pilihan baru.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
value | String | nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir |
isCorrect | Boolean | apakah pilihan tersebut adalah jawaban yang benar |
Return
Choice
— pilihan baru
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
createChoice(value, navigationItem)
Membuat pilihan baru dengan opsi navigasi halaman yang melompat ke item batas halaman tertentu. Ini
setara dengan createChoice(value, navigationType)
dengan navigationType
ditetapkan ke FormApp.PageNavigationType.GO_TO_PAGE
. Pilihan yang menggunakan navigasi
halaman tidak dapat digabungkan di item yang sama dengan pilihan yang tidak menggunakan navigasi halaman.
Navigasi halaman terjadi setelah responden menyelesaikan halaman yang berisi opsi, dan hanya jika responden memilih opsi tersebut. Jika responden memilih beberapa opsi dengan petunjuk navigasi halaman di halaman yang sama, hanya opsi navigasi terakhir yang akan berpengaruh. Navigasi halaman juga tidak berpengaruh pada halaman terakhir formulir.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
value | String | nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir |
navigationItem | PageBreakItem | item yang dibuka |
Return
Choice
— pilihan baru
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(response)
Membuat ItemResponse
baru untuk item pilihan ganda ini. Melempar pengecualian jika
argumen response
tidak cocok dengan pilihan yang valid untuk item ini, kecuali showOtherOption(enabled)
ditetapkan ke true
.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
response | String | jawaban yang valid untuk item pilihan ganda ini |
Return
ItemResponse
— respons item
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
duplicate()
Membuat salinan item ini dan menambahkannya ke akhir formulir.
Return
MultipleChoiceItem
— duplikat dari MultipleChoiceItem
ini, untuk perantaian
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
getChoices()
getFeedbackForCorrect()
Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
Return
QuizFeedback
— masukan, jika 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
getFeedbackForIncorrect()
Menampilkan masukan yang ditampilkan kepada responden jika mereka salah menjawab pertanyaan.
Return
QuizFeedback
— masukan, jika 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
getHelpText()
Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems
, PageBreakItems
, dan SectionHeaderItems
).
Return
String
— teks bantuan atau teks deskripsi item
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 unik item.
Return
Integer
— ID item
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
getIndex()
Mendapatkan indeks item di antara semua item dalam formulir.
Return
Integer
— indeks item
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
getPoints()
Menampilkan nilai poin dari item yang dapat dinilai.
Return
Integer
— jumlah poin nilai sebuah pertanyaan.
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 item (terkadang disebut teks header, untuk SectionHeaderItem
).
Return
String
— judul atau teks header item
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
getType()
hasOtherOption()
Menentukan apakah item memiliki opsi "lainnya".
Return
Boolean
— true
jika item memiliki opsi "other"; 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
isRequired()
Menentukan apakah responden harus menjawab pertanyaan atau tidak.
Return
Boolean
— apakah responden harus menjawab pertanyaan
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
setChoiceValues(values)
Menetapkan pilihan untuk item dari array string. Menampilkan pengecualian jika array yang diberikan kosong.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Parameter
Name | Jenis | Deskripsi |
---|---|---|
values | String[] | array nilai pilihan, yang responden lihat sebagai label saat melihat formulir |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
setChoices(choices)
Menetapkan array pilihan untuk sebuah item. Melempar pengecualian jika array yang diberikan kosong atau berisi elemen null
.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
Parameter
Name | Jenis | Deskripsi |
---|---|---|
choices | Choice[] | array pilihan |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, untuk rantai
Menampilkan
Error
— jika array yang ditentukan adalah null
, kosong, atau berisi elemen null
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
setFeedbackForCorrect(feedback)
Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
feedback | QuizFeedback | masukan baru. Nilai null akan menghapus masukan. |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
setFeedbackForIncorrect(feedback)
Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
feedback | QuizFeedback | masukan baru |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
setHelpText(text)
Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems
, PageBreakItems
, dan SectionHeaderItems
).
Parameter
Name | Jenis | Deskripsi |
---|---|---|
text | String | teks bantuan baru |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
setPoints(points)
Menetapkan jumlah poin untuk item yang dapat dinilai. Default untuk item baru adalah 0.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
points | Integer | jumlah poin nilai item pertanyaan |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
setRequired(enabled)
Menetapkan apakah responden harus menjawab pertanyaan.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | apakah responden harus menjawab pertanyaan |
Return
MultipleChoiceItem
— item saat ini (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 item (terkadang disebut teks header, untuk SectionHeaderItem
).
Parameter
Name | Jenis | Deskripsi |
---|---|---|
title | String | judul atau teks header baru |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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
showOtherOption(enabled)
Menetapkan apakah item memiliki opsi "quot;other". Default untuk CheckboxItem
atau
MultipleChoiceItem
baru adalah false
.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | true jika item memiliki opsi "lainnya" false jika tidak |
Return
MultipleChoiceItem
— ini MultipleChoiceItem
, 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