Item pertanyaan, dibacakan sebagai petak kolom dan baris, yang memungkinkan responden memilih
beberapa pilihan per baris dari
urutan kotak centang. Item dapat diakses atau dibuat dari
Form
.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
clearValidation() | CheckboxGridItem | Menghapus validasi data untuk item petak ini. |
createResponse(responses) | ItemResponse | Membuat ItemResponse baru untuk item petak kotak centang ini. |
duplicate() | CheckboxGridItem | Membuat salinan item ini dan menambahkannya ke bagian akhir formulir. |
getColumns() | String[] | Mendapatkan nilai untuk setiap kolom dalam grid. |
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. |
getRows() | String[] | Mendapatkan nilai untuk setiap baris dalam petak. |
getTitle() | String | Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem ). |
getType() | ItemType | Mendapatkan jenis item, yang direpresentasikan sebagai ItemType . |
isRequired() | Boolean | Menentukan apakah responden harus menjawab pertanyaan. |
setColumns(columns) | CheckboxGridItem | Menetapkan kolom petak berdasarkan array nilai. |
setHelpText(text) | CheckboxGridItem | Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems , PageBreakItems , dan SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | Menetapkan apakah responden harus menjawab pertanyaan. |
setRows(rows) | CheckboxGridItem | Menetapkan baris petak berdasarkan array nilai. |
setTitle(title) | CheckboxGridItem | Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | Menetapkan validasi data untuk item petak kotak centang ini. |
Dokumentasi mendetail
clearValidation()
Menghapus validasi data untuk item petak ini.
Pulang pergi
CheckboxGridItem
— item 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
createResponse(responses)
Membuat ItemResponse
baru untuk item petak kotak centang ini. Argumen responses
harus berupa array String[][]
yang berisi nilai sebanyak jumlah input
di kisi kotak centang. Elemen null
untuk pertanyaan petak kotak centang yang tidak diperlukan
menunjukkan tidak ada respons terhadap baris tersebut. Menampilkan pengecualian jika salah satu nilai tidak cocok dengan
pilihan yang valid.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
responses | String[][] | array jawaban yang valid untuk item petak kotak centang 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
CheckboxGridItem
— duplikat dari CheckboxGridItem
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
getColumns()
Mendapatkan nilai untuk setiap kolom dalam grid.
Pulang pergi
String[]
— array nilai kolom, yang dilihat responden sebagai label saat melihat formulir
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
getRows()
Mendapatkan nilai untuk setiap baris dalam petak.
Pulang pergi
String[]
— array nilai baris, yang dilihat responden sebagai label saat melihat formulir
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()
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
setColumns(columns)
Menetapkan kolom petak berdasarkan array nilai. Menampilkan pengecualian jika yang diberikan array kosong.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columns | String[] | array nilai kolom, yang dilihat responden sebagai label saat melihat formulir |
Pulang pergi
CheckboxGridItem
— item ini, untuk perantaian
Menampilkan
Error
— jika array yang diberikan adalah null
atau kosong
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
CheckboxGridItem
— CheckboxGridItem
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
Nama | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | apakah responden harus menjawab pertanyaan atau tidak |
Pulang pergi
CheckboxGridItem
— 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
setRows(rows)
Menetapkan baris petak berdasarkan array nilai. Menampilkan pengecualian jika array yang diberikan kosong.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rows | String[] | array nilai baris, yang dilihat responden sebagai label saat melihat formulir |
Pulang pergi
CheckboxGridItem
— item ini, untuk perantaian
Menampilkan
Error
— jika array yang diberikan adalah null
atau kosong
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 |
Pulang pergi
CheckboxGridItem
— CheckboxGridItem
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
setValidation(validation)
Menetapkan validasi data untuk item petak kotak centang ini. Meneruskan {i>null <i}atau validasi tanpa fungsi wajib yang dipanggil akan menghapus validasi sebelumnya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
validation | CheckboxGridValidation | CheckboxGridValidation untuk diterapkan ke item ini. |
Pulang pergi
CheckboxGridItem
— CheckboxGridItem
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