Halaman ini diterjemahkan oleh Cloud Translation API.

Class CheckboxItem

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 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 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)`	`CheckboxItem`	Menetapkan pilihan untuk item dari array string.
`setChoices(choices)`	`CheckboxItem`	Menetapkan array pilihan untuk item.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Menetapkan masukan yang akan ditampilkan kepada responden ketika mereka menjawab pertanyaan dengan benar.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Menetapkan masukan yang akan ditampilkan kepada responden saat mereka merespons pertanyaan dengan tidak benar.
`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.

Return

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

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

`createResponse(responses)`

Membuat ItemResponse baru untuk item kotak centang ini. Argumen responses adalah array String[] 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

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

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

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

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

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 merespons pertanyaan dengan tidak benar.

Parameter

Nama	Jenis	Deskripsi
`feedback`	`QuizFeedback`	masukan yang baru

Return

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

Nama	Jenis	Deskripsi
`text`	`String`	teks bantuan baru

Return

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

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

Nama	Jenis	Deskripsi
`enabled`	`Boolean`	apakah responden harus menjawab pertanyaan

Return

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

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 wajib akan menghapus validasi sebelumnya.

Parameter

Nama	Jenis	Deskripsi
`validation`	`CheckboxValidation`	{i>CheckboxValidation<i} untuk diterapkan ke item ini.

Return

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

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

Return

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