Class CheckboxItem

CheckboxItem

Item pertanyaan yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya" opsional. Item dibuat atau diakses dari Form menggunakan metode seperti Form.addCheckboxItem(). Jika digunakan dalam kuis, item ini akan dinilai secara otomatis.

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 nilai 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 suatu item.
getFeedbackForCorrect()	QuizFeedback|null	Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
getFeedbackForIncorrect()	QuizFeedback|null	Menampilkan masukan yang ditunjukkan kepada responden saat mereka menjawab pertanyaan dengan salah.
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 direpresentasikan sebagai ItemType.
hasOtherOption()	Boolean	Menentukan apakah item memiliki opsi "lainnya".
isRequired()	Boolean	Menentukan apakah responden harus menjawab pertanyaan.
setChoiceValues(values)	CheckboxItem	Menetapkan pilihan untuk item dari array string.
setChoices(choices)	CheckboxItem	Menetapkan array pilihan untuk suatu item.
setFeedbackForCorrect(feedback)	CheckboxItem	Menetapkan masukan yang akan ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
setFeedbackForIncorrect(feedback)	CheckboxItem	Menetapkan masukan yang akan ditampilkan kepada responden saat mereka menjawab pertanyaan dengan salah.
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 yang bernilai untuk item yang dapat dinilai.
setRequired(enabled)	CheckboxItem	Menetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)	CheckboxItem	Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
setValidation(validation)	CheckboxItem	Menetapkan validasi data untuk item kotak centang ini.
showOtherOption(enabled)	CheckboxItem	Menetapkan apakah item memiliki opsi "lainnya".

Dokumentasi mendetail

clearValidation()

Menghapus validasi data untuk item kotak centang ini.

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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

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

Pulang pergi

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 tersebut adalah jawaban yang benar

Pulang pergi

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

Parameter

Nama	Jenis	Deskripsi
responses	String[]	array jawaban yang valid untuk item pilihan ganda ini

Pulang pergi

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.

Pulang pergi

CheckboxItem — duplikat dari CheckboxItem ini, untuk dirangkaikan

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.

Pulang pergi

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 saat mereka menjawab pertanyaan dengan benar.

Pulang pergi

QuizFeedback|null — 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 ditunjukkan kepada responden saat mereka menjawab pertanyaan dengan salah.

Pulang pergi

QuizFeedback|null — 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).

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

Integer — jumlah poin yang diperoleh dari 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).

Pulang pergi

String — judul item atau teks header

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 direpresentasikan sebagai ItemType.

Pulang pergi

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".

Pulang pergi

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.

Pulang pergi

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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 suatu item. Menampilkan pengecualian jika array yang diberikan kosong atau berisi elemen null.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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[]	berbagai pilihan

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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 saat mereka menjawab pertanyaan dengan benar.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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().setText('Dogs rule, cats drool.').build(),
);

Parameter

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

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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 menjawab pertanyaan dengan salah.

Parameter

Nama	Jenis	Deskripsi
feedback	QuizFeedback	masukan baru

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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. Nilai default untuk item baru adalah 0.

Parameter

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

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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 tersebut

Pulang pergi

CheckboxItem — item saat ini (untuk merangkai)

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 header baru

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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 nilai null atau validasi tanpa memanggil fungsi require akan menghapus validasi sebelumnya.

Parameter

Nama	Jenis	Deskripsi
validation	CheckboxValidation	CheckboxValidation yang akan diterapkan ke item ini.

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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

Pulang pergi

CheckboxItem — CheckboxItem ini, untuk dirangkaikan

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