Class ListItem

ListItem

Item pertanyaan yang memungkinkan responden memilih satu pilihan dari menu drop-down. Item dapat diakses atau dibuat dari Form. 

// 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?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
    ]);

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
createChoice(value)ChoiceMembuat pilihan baru.
createChoice(value, isCorrect)ChoiceMembuat pilihan baru.
createChoice(value, navigationItem)ChoiceMembuat pilihan baru dengan opsi navigasi halaman yang melompat ke item batas halaman tertentu.
createChoice(value, navigationType)ChoiceMembuat pilihan baru dengan opsi navigasi halaman.
createResponse(response)ItemResponseMembuat ItemResponse baru untuk item daftar ini.
duplicate()ListItemMembuat salinan item ini dan menambahkannya ke bagian akhir formulir.
getChoices()Choice[]Mendapatkan semua pilihan untuk suatu item.
getFeedbackForCorrect()QuizFeedbackMenampilkan masukan yang ditampilkan kepada responden saat mereka merespons 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 dari item yang dapat dinilai.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan.
setChoiceValues(values)ListItemMenetapkan pilihan untuk item dari array string.
setChoices(choices)ListItemMenetapkan array pilihan untuk sebuah item.
setFeedbackForCorrect(feedback)ListItemMenetapkan masukan untuk ditampilkan kepada responden saat mereka merespons pertanyaan dengan benar.
setFeedbackForIncorrect(feedback)ListItemMenetapkan masukan untuk ditampilkan kepada responden saat mereka salah merespons pertanyaan.
setHelpText(text)ListItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setPoints(points)ListItemMenetapkan jumlah titik nilai item yang dapat dinilai.
setRequired(enabled)ListItemMenetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)ListItemMenetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Dokumentasi mendetail

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

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 halaman navigasi 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 pada halaman yang sama, hanya opsi navigasi terakhir yang akan memberikan pengaruh. Navigasi halaman juga tidak berpengaruh pada halaman terakhir formulir.

Parameter

NamaJenisDeskripsi
valueStringnilai pilihan, yang dilihat responden sebagai label saat melihat formulir
navigationItemPageBreakItemitem yang akan dibuka

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

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 pada halaman yang sama, hanya opsi navigasi terakhir yang akan memberikan pengaruh. Navigasi halaman juga tidak berpengaruh pada halaman terakhir formulir.

Parameter

NamaJenisDeskripsi
valueStringnilai pilihan, yang dilihat responden sebagai label saat melihat formulir
navigationTypePageNavigationTypejenis navigasi pilihan

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

Membuat ItemResponse baru untuk item daftar ini. Menampilkan pengecualian jika argumen response tidak cocok dengan pilihan yang valid untuk item ini.

Parameter

NamaJenisDeskripsi
responseStringjawaban yang valid untuk item daftar 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 bagian akhir formulir.

Pulang pergi

ListItem — duplikat dari ListItem 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.

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

Pulang pergi

Integer — jumlah poin yang bernilai untuk 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).

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

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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parameter

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

Pulang pergi

ListItem — ListItem ini, untuk perantai

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

NamaJenisDeskripsi
choicesChoice[]array pilihan

Pulang pergi

ListItem — ListItem ini, untuk perantai

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 untuk ditampilkan kepada responden saat mereka merespons 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

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan baru. Nilai {i>null <i}akan menghapus {i>feedback<i}.

Pulang pergi

ListItem — ListItem ini, untuk perantai

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 untuk ditampilkan kepada responden saat mereka salah merespons pertanyaan.

Parameter

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan baru

Pulang pergi

ListItem — ListItem ini, untuk perantai

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

ListItem — ListItem ini, untuk perantai

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 titik nilai item yang dapat dinilai. Default untuk item baru adalah 0.

Parameter

NamaJenisDeskripsi
pointsIntegerjumlah poin yang bernilai untuk item pertanyaan

Pulang pergi

ListItem — ListItem ini, untuk perantai

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

Pulang pergi

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

NamaJenisDeskripsi
titleStringjudul atau teks {i>header <i}baru

Pulang pergi

ListItem — ListItem ini, untuk perantai

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