Halaman ini diterjemahkan oleh Cloud Translation API.

Class MultipleChoiceItem

Item pertanyaan yang memungkinkan responden memilih satu pilihan dari daftar tombol pilihan atau kolom "lainnya&quot 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 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 batas 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 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)`	`MultipleChoiceItem`	Menetapkan pilihan untuk item dari array string.
`setChoices(choices)`	`MultipleChoiceItem`	Menetapkan array pilihan untuk sebuah item.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan.
`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 untuk item yang dapat dinilai.
`setRequired(enabled)`	`MultipleChoiceItem`	Menetapkan apakah responden harus menjawab pertanyaan.
`setTitle(title)`	`MultipleChoiceItem`	Menetapkan judul item (terkadang disebut teks header, untuk `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	Menetapkan apakah item memiliki opsi "quot;other".

Dokumentasi mendetail

`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

`createChoice(value, navigationItem)`

Membuat pilihan baru dengan opsi navigasi halaman yang melompat ke item batas halaman tertentu. Ini setara dengan createChoice(value, navigationType) dengan navigationType ditetapkan ke FormApp.PageNavigationType.GO_TO_PAGE. Pilihan yang menggunakan navigasi halaman tidak dapat digabungkan di 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

Name	Jenis	Deskripsi
`value`	`String`	nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir
`navigationItem`	`PageBreakItem`	item yang 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 digabungkan dalam item yang sama dengan pilihan yang tidak menggunakan navigasi halaman.

Parameter

Name	Jenis	Deskripsi
`value`	`String`	nilai pilihan yang akan 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. Melempar pengecualian jika argumen response tidak cocok dengan pilihan yang valid untuk item ini, kecuali showOtherOption(enabled) ditetapkan ke true.

Parameter

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

Mendapatkan jenis item, yang direpresentasikan 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 "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

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

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

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

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

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

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

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

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

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