Class GridItem

GridItem

Item pertanyaan, dibacakan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan. Item dapat diakses atau dibuat dari Form.

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Metode

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

Dokumentasi mendetail

clearValidation()

Menghapus validasi data untuk item petak ini.

Pulang pergi

GridItem — 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 ini. Argumen responses harus berupa Array String[] yang berisi nilai sebanyak jumlah baris dalam petak. Elemen null untuk pertanyaan petak yang tidak diperlukan menunjukkan tidak ada respons terhadap baris tersebut. Menampilkan pengecualian jika ada nilai yang tidak cocok dengan pilihan yang valid.

Parameter

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

GridItem — duplikat dari GridItem 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()

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 yang diberikan array kosong.

Parameter

NamaJenisDeskripsi
columnsString[]array nilai kolom, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

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

NamaJenisDeskripsi
textStringteks bantuan baru

Pulang pergi

GridItemGridItem 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

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

NamaJenisDeskripsi
rowsString[]array nilai baris, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

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

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

Pulang pergi

GridItemGridItem 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 ini. Meneruskan null atau validasi tanpa nilai apa pun fungsi yang dipanggil akan menghapus validasi sebelumnya.

Parameter

NamaJenisDeskripsi
validationGridValidationGridValidation untuk diterapkan ke item ini.

Pulang pergi

GridItemGridItem 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