Halaman ini diterjemahkan oleh Cloud Translation API.

Class GridItem

Item pertanyaan, disajikan 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

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`clearValidation()`	`GridItem`	Menghapus validasi data untuk item petak ini.
`createResponse(responses)`	`ItemResponse`	Membuat `ItemResponse` baru untuk item petak ini.
`duplicate()`	`GridItem`	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, untuk `SectionHeaderItem`).
`getType()`	`ItemType`	Mendapatkan jenis item, yang direpresentasikan sebagai `ItemType`.
`isRequired()`	`Boolean`	Menentukan apakah responden harus menjawab pertanyaan atau tidak.
`setColumns(columns)`	`GridItem`	Menetapkan kolom petak berdasarkan array nilai.
`setHelpText(text)`	`GridItem`	Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti `ImageItems`, `PageBreakItems`, dan `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Menetapkan apakah responden harus menjawab pertanyaan.
`setRows(rows)`	`GridItem`	Menetapkan baris petak berdasarkan array nilai.
`setTitle(title)`	`GridItem`	Menetapkan judul item (terkadang disebut teks header, untuk `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	Menetapkan validasi data untuk item petak ini.

Dokumentasi mendetail

`clearValidation()`

Menghapus validasi data untuk item petak ini.

Return

GridItem — 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 ini. Argumen responses harus berupa array String[] yang berisi nilai sebanyak jumlah baris dalam petak. Elemen null untuk pertanyaan petak yang tidak wajib mengindikasikan tidak adanya respons terhadap baris tersebut. Melempar pengecualian jika salah satu nilai tidak cocok dengan pilihan yang valid.

Parameter

Name	Jenis	Deskripsi
`responses`	`String[]`	array jawaban yang valid untuk item petak 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

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

Name	Jenis	Deskripsi
`columns`	`String[]`	array nilai kolom, yang responden lihat sebagai label saat melihat formulir

Return

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

Name	Jenis	Deskripsi
`text`	`String`	teks bantuan baru

Return

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

Name	Jenis	Deskripsi
`enabled`	`Boolean`	apakah responden harus menjawab pertanyaan

Return

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

Name	Jenis	Deskripsi
`rows`	`String[]`	array nilai baris, yang dianggap responden sebagai label saat melihat formulir

Return

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

Name	Jenis	Deskripsi
`title`	`String`	judul atau teks header baru

Return

GridItem — ini GridItem, 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 ini. Meneruskan null atau validasi tanpa fungsi yang dipanggil akan memanggil validasi sebelumnya.

Parameter

Name	Jenis	Deskripsi
`validation`	`GridValidation`	GridValidation untuk diterapkan ke item ini.

Return

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