Class CheckboxGridItem

Kotak CentangPetakItem

Item pertanyaan, yang ditampilkan 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 checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 apa pun 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 akhir formulir.
getColumns()	String[]	Mendapatkan nilai untuk setiap kolom dalam petak.
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 apa pun untuk item petak ini.

Pulang pergi

CheckboxGridItem — item 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

---

createResponse(responses)

Membuat ItemResponse baru untuk item petak kotak centang ini. Argumen responses harus berupa array String[][] dari array yang berisi nilai sebanyak jumlah input di petak kotak centang. Elemen null untuk pertanyaan petak kotak centang yang tidak wajib menunjukkan tidak ada respons untuk baris tersebut. Menampilkan pengecualian jika salah satu nilai tidak cocok dengan pilihan yang valid.

Parameter

Nama	Jenis	Deskripsi
responses	String[][]	array 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 akhir formulir.

Pulang pergi

CheckboxGridItem — duplikat dari CheckboxGridItem 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

---

getColumns()

Mendapatkan nilai untuk setiap kolom dalam petak.

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

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

---

setColumns(columns)

Menetapkan kolom petak berdasarkan array nilai. Menampilkan pengecualian jika array yang diberikan kosong.

Parameter

Nama	Jenis	Deskripsi
columns	String[]	array nilai kolom, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

CheckboxGridItem — item ini, untuk pembuatan rantai

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

Pulang pergi

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

---

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

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	teks judul atau header baru

Pulang pergi

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

---

setValidation(validation)

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

Parameter

Nama	Jenis	Deskripsi
validation	CheckboxGridValidation	CheckboxGridValidation yang akan diterapkan ke item ini.

Pulang pergi

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