Class CheckboxGridItem

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
CheckBoxGridItem

Item pertanyaan, yang ditampilkan sebagai petak kolom dan baris, 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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
clearValidation()CheckboxGridItemMenghapus validasi data untuk item petak ini.
createResponse(responses)ItemResponseMembuat ItemResponse baru untuk item petak kotak centang ini.
duplicate()CheckboxGridItemMembuat salinan item ini dan menambahkannya ke akhir formulir.
getColumns()String[]Mendapatkan nilai untuk setiap kolom dalam petak.
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.
getRows()String[]Mendapatkan nilai untuk setiap baris dalam petak.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, untuk SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan atau tidak.
setColumns(columns)CheckboxGridItemMenetapkan kolom petak berdasarkan array nilai.
setHelpText(text)CheckboxGridItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setRequired(enabled)CheckboxGridItemMenetapkan apakah responden harus menjawab pertanyaan.
setRows(rows)CheckboxGridItemMenetapkan baris petak berdasarkan array nilai.
setTitle(title)CheckboxGridItemMenetapkan judul item (terkadang disebut teks header, untuk SectionHeaderItem).
setValidation(validation)CheckboxGridItemMenetapkan validasi data untuk item petak kotak centang ini.

Dokumentasi mendetail

clearValidation()

Menghapus validasi data untuk item petak ini.

Return

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

createResponse(responses)

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

Parameter

NameJenisDeskripsi
responsesString[][]array array jawaban yang valid untuk item petak kotak centang 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

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

Return

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

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

getRows()

Mendapatkan nilai untuk setiap baris dalam petak.

Return

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

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

setColumns(columns)

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

Parameter

NameJenisDeskripsi
columnsString[]array nilai kolom, yang responden lihat sebagai label saat melihat formulir

Return

CheckboxGridItem — item ini, untuk 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

NameJenisDeskripsi
textStringteks bantuan baru

Return

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

NameJenisDeskripsi
enabledBooleanapakah responden harus menjawab pertanyaan

Return

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

setRows(rows)

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

Parameter

NameJenisDeskripsi
rowsString[]array nilai baris, yang dianggap responden sebagai label saat melihat formulir

Return

CheckboxGridItem — item ini, untuk 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, untuk SectionHeaderItem).

Parameter

NameJenisDeskripsi
titleStringjudul atau teks header baru

Return

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

setValidation(validation)

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

Parameter

NameJenisDeskripsi
validationCheckboxGridValidationsebuah CheckboxGridValidation untuk diterapkan ke item ini.

Return

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