Class CheckboxItem

ItemKotak centang

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
clearValidation()CheckboxItemMenghapus validasi data apa pun untuk item kotak centang ini.
createChoice(value)ChoiceMembuat pilihan baru.
createChoice(value, isCorrect)ChoiceMembuat pilihan baru.
createResponse(responses)ItemResponseMembuat ItemResponse baru untuk item kotak centang ini.
duplicate()CheckboxItemMembuat salinan item ini dan menambahkannya ke akhir formulir.
getChoices()Choice[]Mendapatkan semua pilihan untuk item.
getFeedbackForCorrect()QuizFeedbackMenampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
getFeedbackForIncorrect()QuizFeedbackMenampilkan masukan yang ditampilkan kepada responden saat mereka salah menjawab pertanyaan.
getHelpText()StringMendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
getId()IntegerMendapatkan ID unik item.
getIndex()IntegerMendapatkan indeks item di antara semua item dalam formulir.
getPoints()IntegerMenampilkan nilai poin item yang dapat dinilai.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
hasOtherOption()BooleanMenentukan apakah item memiliki opsi "lainnya".
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan.
setChoiceValues(values)CheckboxItemMenetapkan pilihan untuk item dari array string.
setChoices(choices)CheckboxItemMenetapkan array pilihan untuk item.
setFeedbackForCorrect(feedback)CheckboxItemMenetapkan masukan yang akan ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
setFeedbackForIncorrect(feedback)CheckboxItemMenetapkan masukan yang akan ditampilkan kepada responden saat mereka salah menjawab pertanyaan.
setHelpText(text)CheckboxItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setPoints(points)CheckboxItemMenetapkan jumlah poin yang diperoleh item yang dapat dinilai.
setRequired(enabled)CheckboxItemMenetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)CheckboxItemMenetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
setValidation(validation)CheckboxItemMenetapkan validasi data untuk item kotak centang ini.
showOtherOption(enabled)CheckboxItemMenetapkan apakah item memiliki opsi "lainnya".

Dokumentasi mendetail

clearValidation()

Menghapus validasi data apa pun untuk item kotak centang ini.

Pulang pergi

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

createChoice(value)

Membuat pilihan baru.

Parameter

NamaJenisDeskripsi
valueStringnilai 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

NamaJenisDeskripsi
valueStringnilai pilihan, yang dilihat responden sebagai label saat melihat formulir
isCorrectBooleanapakah pilihan tersebut merupakan 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 nilai apa pun tidak cocok dengan pilihan yang valid untuk item ini, kecuali jika showOtherOption(enabled) ditetapkan ke true.

Parameter

NamaJenisDeskripsi
responsesString[]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 penyambungan

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

Pulang pergi

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

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 pantas untuk 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 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()

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

NamaJenisDeskripsi
valuesString[]array nilai pilihan, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

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

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

NamaJenisDeskripsi
choicesChoice[]array pilihan

Pulang pergi

CheckboxItem — CheckboxItem 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 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().setDisplayText('Dogs rule, cats drool.').build(),
);

Parameter

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan baru. Nilai null akan menghapus masukan.

Pulang pergi

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

setFeedbackForIncorrect(feedback)

Menetapkan masukan yang akan ditampilkan kepada responden saat mereka salah menjawab pertanyaan.

Parameter

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan baru

Pulang pergi

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

setHelpText(text)

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

Parameter

NamaJenisDeskripsi
textStringteks bantuan baru

Pulang pergi

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

setPoints(points)

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

Parameter

NamaJenisDeskripsi
pointsIntegerjumlah poin yang pantas untuk item pertanyaan

Pulang pergi

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

setRequired(enabled)

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

NamaJenisDeskripsi
enabledBooleanapakah responden harus menjawab pertanyaan

Pulang pergi

CheckboxItem — item saat ini (untuk pembuatan 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, dalam kasus SectionHeaderItem).

Parameter

NamaJenisDeskripsi
titleStringteks judul atau header baru

Pulang pergi

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

setValidation(validation)

Menetapkan validasi data untuk item kotak centang ini. Meneruskan null atau validasi tanpa memanggil fungsi yang diperlukan akan menghapus validasi sebelumnya.

Parameter

NamaJenisDeskripsi
validationCheckboxValidationCheckboxValidation yang akan diterapkan ke item ini.

Pulang pergi

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

showOtherOption(enabled)

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

Parameter

NamaJenisDeskripsi
enabledBooleantrue jika item memiliki opsi "lainnya"; false jika tidak

Pulang pergi

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