Class MultipleChoiceItem

MultipleChoiceItem

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 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 jeda 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 suatu item.
getFeedbackForCorrect()	QuizFeedback	Menampilkan masukan yang ditampilkan kepada responden ketika mereka merespons pertanyaan dengan benar.
getFeedbackForIncorrect()	QuizFeedback	Menampilkan masukan yang ditampilkan kepada responden saat mereka merespons pertanyaan dengan tidak benar.
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 item yang dapat dinilai.
getTitle()	String	Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()	ItemType	Mendapatkan jenis item yang ditampilkan sebagai ItemType.
hasOtherOption()	Boolean	Menentukan apakah item memiliki opsi "lainnya".
isRequired()	Boolean	Menentukan apakah responden harus menjawab pertanyaan.
setChoiceValues(values)	MultipleChoiceItem	Menetapkan pilihan untuk item dari array string.
setChoices(choices)	MultipleChoiceItem	Menetapkan array pilihan untuk item.
setFeedbackForCorrect(feedback)	MultipleChoiceItem	Menetapkan masukan yang akan ditampilkan kepada responden ketika mereka menjawab pertanyaan dengan benar.
setFeedbackForIncorrect(feedback)	MultipleChoiceItem	Menetapkan masukan yang akan ditampilkan kepada responden saat mereka merespons pertanyaan dengan tidak benar.
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 yang bernilai untuk item yang dapat dinilai.
setRequired(enabled)	MultipleChoiceItem	Menetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)	MultipleChoiceItem	Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
showOtherOption(enabled)	MultipleChoiceItem	Menetapkan apakah item memiliki opsi "lainnya".

Dokumentasi mendetail

createChoice(value)

Membuat pilihan baru.

Parameter

Nama	Jenis	Deskripsi
value	String	nilai pilihan, yang 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

Nama	Jenis	Deskripsi
value	String	nilai pilihan, yang dilihat responden sebagai label saat melihat formulir
isCorrect	Boolean	apakah pilihan 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 jeda halaman tertentu. Ini setara dengan createChoice(value, navigationType) dengan navigationType yang ditetapkan ke FormApp.PageNavigationType.GO_TO_PAGE. Pilihan yang menggunakan navigasi halaman tidak dapat digabungkan dalam 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

Nama	Jenis	Deskripsi
value	String	nilai pilihan, yang dilihat responden sebagai label saat melihat formulir
navigationItem	PageBreakItem	item yang akan 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

---

createChoice(value, navigationType)

Membuat pilihan baru dengan opsi navigasi halaman. Pilihan yang menggunakan navigasi halaman tidak dapat dikombinasikan dalam 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

Nama	Jenis	Deskripsi
value	String	nilai pilihan, yang dilihat responden sebagai label saat melihat formulir
navigationType	PageNavigationType	jenis navigasi pilihan

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. Menampilkan pengecualian jika argumen response tidak cocok dengan pilihan yang valid untuk item ini, kecuali jika showOtherOption(enabled) ditetapkan ke true.

Parameter

Nama	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()

Mendapatkan semua pilihan untuk suatu item.

Return

Choice[] — array pilihan

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

---

getFeedbackForCorrect()

Menampilkan masukan yang ditampilkan kepada responden ketika mereka merespons 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 saat mereka merespons pertanyaan dengan tidak 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

---

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 item yang dapat dinilai.

Return

Integer — jumlah poin yang dimiliki 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, dalam kasus SectionHeaderItem).

Return

String — teks judul atau 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()

Mendapatkan jenis item yang ditampilkan sebagai ItemType.

Return

ItemType — jenis 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

---

hasOtherOption()

Menentukan apakah item memiliki opsi "lainnya".

Return

Boolean — true jika item memiliki opsi "lainnya"; 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.

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

Nama	Jenis	Deskripsi
values	String[]	array nilai pilihan, yang dilihat responden sebagai label saat melihat formulir

Return

MultipleChoiceItem — 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

---

setChoices(choices)

Menetapkan array pilihan untuk item. Menampilkan 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

Nama	Jenis	Deskripsi
choices	Choice[]	array pilihan

Return

MultipleChoiceItem — MultipleChoiceItem ini, untuk perantaian

Menampilkan

Error — jika array yang diberikan 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 yang akan ditampilkan kepada responden ketika 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

Nama	Jenis	Deskripsi
feedback	QuizFeedback	masukan yang baru. Nilai null akan menghapus masukan.

Return

MultipleChoiceItem — 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

---

setFeedbackForIncorrect(feedback)

Menetapkan masukan yang akan ditampilkan kepada responden saat mereka merespons pertanyaan dengan tidak benar.

Parameter

Nama	Jenis	Deskripsi
feedback	QuizFeedback	masukan yang baru

Return

MultipleChoiceItem — 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

---

setHelpText(text)

Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Parameter

Nama	Jenis	Deskripsi
text	String	teks bantuan baru

Return

MultipleChoiceItem — 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

---

setPoints(points)

Menetapkan jumlah poin yang bernilai untuk item yang dapat dinilai. Default untuk item baru adalah 0.

Parameter

Nama	Jenis	Deskripsi
points	Integer	jumlah poin yang bernilai dari item pertanyaan

Return

MultipleChoiceItem — 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

---

setRequired(enabled)

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	apakah responden harus menjawab pertanyaan

Return

MultipleChoiceItem — item saat 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

---

setTitle(title)

Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Parameter

Nama	Jenis	Deskripsi
title	String	judul atau teks {i>header<i} baru

Return

MultipleChoiceItem — 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

---

showOtherOption(enabled)

Menetapkan apakah item memiliki opsi "lainnya". Default untuk CheckboxItem atau MultipleChoiceItem baru adalah false.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika item memiliki opsi "lainnya"; false jika tidak

Return

MultipleChoiceItem — 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