Item pertanyaan yang memungkinkan responden memilih satu atau beberapa kotak centang, serta
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 checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
clearValidation() | CheckboxItem | Menghapus validasi data untuk item kotak centang ini. |
createChoice(value) | Choice | Membuat pilihan baru. |
createChoice(value, isCorrect) | Choice | Membuat pilihan baru. |
createResponse(responses) | ItemResponse | Membuat ItemResponse baru untuk item kotak centang ini. |
duplicate() | CheckboxItem | 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) | CheckboxItem | Menetapkan pilihan untuk item dari array string. |
setChoices(choices) | CheckboxItem | Menetapkan array pilihan untuk sebuah item. |
setFeedbackForCorrect(feedback) | CheckboxItem | Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan. |
setHelpText(text) | CheckboxItem | Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems , PageBreakItems , dan SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Menetapkan jumlah poin untuk item yang dapat dinilai. |
setRequired(enabled) | CheckboxItem | Menetapkan apakah responden harus menjawab pertanyaan. |
setTitle(title) | CheckboxItem | Menetapkan judul item (terkadang disebut teks header, untuk SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Menetapkan validasi data untuk item kotak centang ini. |
showOtherOption(enabled) | CheckboxItem | Menetapkan apakah item memiliki opsi "quot;other". |
Dokumentasi mendetail
clearValidation()
Menghapus validasi data untuk item kotak centang ini.
Return
CheckboxItem
— ini CheckboxItem
, 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
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
createResponse(responses)
Membuat ItemResponse
baru untuk item kotak centang ini. Argumen responses
adalah
array String[]
yang berisi nilai yang perlu diperiksa. Melempar pengecualian jika ada nilai yang tidak cocok dengan pilihan yang valid untuk item ini, kecuali showOtherOption(enabled)
ditetapkan ke true
.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
responses | String[] | array 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
CheckboxItem
— duplikat dari CheckboxItem
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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— 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
CheckboxItem
— ini CheckboxItem
, 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
setValidation(validation)
Menetapkan validasi data untuk item kotak centang ini. Meneruskan null atau validasi tanpa fungsi yang dipanggil akan memanggil validasi sebelumnya.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
validation | CheckboxValidation | sebuah CheckboxValidation untuk diterapkan ke item ini. |
Return
CheckboxItem
— ini CheckboxItem
, 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
CheckboxItem
— ini CheckboxItem
, 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