Halaman ini diterjemahkan oleh Cloud Translation API.

Interface Item

Item formulir umum yang berisi properti umum untuk semua item, seperti judul dan teks bantuan. Item dapat diakses atau dibuat dari Form.

Untuk beroperasi di properti khusus jenis, gunakan getType() untuk memeriksa ItemType item, lalu transmisikan item ke class yang sesuai menggunakan metode seperti asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Mengimplementasikan class

Nama	Deskripsi singkat

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`asCheckboxGridItem()`	`CheckboxGridItem`	Menampilkan item sebagai item petak kotak centang.
`asCheckboxItem()`	`CheckboxItem`	Menampilkan item sebagai item kotak centang.
`asDateItem()`	`DateItem`	Menampilkan item sebagai item tanggal.
`asDateTimeItem()`	`DateTimeItem`	Menampilkan item sebagai item tanggal-waktu.
`asDurationItem()`	`DurationItem`	Menampilkan item sebagai item durasi.
`asGridItem()`	`GridItem`	Menampilkan item sebagai item petak.
`asImageItem()`	`ImageItem`	Menampilkan item sebagai item gambar.
`asListItem()`	`ListItem`	Menampilkan item sebagai item daftar.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Menampilkan item sebagai item pilihan ganda.
`asPageBreakItem()`	`PageBreakItem`	Menampilkan item sebagai item jeda halaman.
`asParagraphTextItem()`	`ParagraphTextItem`	Menampilkan item sebagai item teks paragraf.
`asScaleItem()`	`ScaleItem`	Menampilkan item sebagai item skala.
`asSectionHeaderItem()`	`SectionHeaderItem`	Menampilkan item sebagai item header bagian.
`asTextItem()`	`TextItem`	Menampilkan item sebagai item teks.
`asTimeItem()`	`TimeItem`	Menampilkan item sebagai item waktu.
`asVideoItem()`	`VideoItem`	Menampilkan item sebagai item video.
`duplicate()`	`Item`	Membuat salinan item ini dan menambahkannya ke akhir formulir.
`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.
`getTitle()`	`String`	Mendapatkan judul item (terkadang disebut teks header, dalam kasus `SectionHeaderItem`).
`getType()`	`ItemType`	Mendapatkan jenis item yang ditampilkan sebagai `ItemType`.
`setHelpText(text)`	`Item`	Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti `ImageItems`, `PageBreakItems`, dan `SectionHeaderItems`).
`setTitle(title)`	`Item`	Menetapkan judul item (terkadang disebut teks header, dalam kasus `SectionHeaderItem`).

Dokumentasi mendetail

`asCheckboxGridItem()`

Menampilkan item sebagai item petak kotak centang. Menampilkan pengecualian skrip jika ItemType belum berupa CHECKBOX_GRID.

Return

CheckboxGridItem — item petak kotak centang

Menampilkan

Error — jika item bukan item petak kotak centang

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

`asCheckboxItem()`

Menampilkan item sebagai item kotak centang. Menampilkan pengecualian skrip jika ItemType belum berupa CHECKBOX.

Return

CheckboxItem — item kotak centang

Menampilkan

Error — jika item bukan item kotak centang

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

`asDateItem()`

Menampilkan item sebagai item tanggal. Menampilkan pengecualian skrip jika ItemType belum berupa DATE.

Return

DateItem — item tanggal

Menampilkan

Error — jika item bukan item tanggal

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

`asDateTimeItem()`

Menampilkan item sebagai item tanggal-waktu. Menampilkan pengecualian skrip jika ItemType belum berupa DATETIME.

Return

DateTimeItem — item tanggal-waktu

Menampilkan

Error — jika item bukan item tanggal-waktu

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

`asDurationItem()`

Menampilkan item sebagai item durasi. Menampilkan pengecualian skrip jika ItemType belum berupa DURATION.

Return

DurationItem — item durasi

Menampilkan

Error — jika item bukan item durasi

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

`asGridItem()`

Menampilkan item sebagai item petak. Menampilkan pengecualian skrip jika ItemType belum berupa GRID.

Return

GridItem — item petak

Menampilkan

Error — jika item bukan item petak

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

`asImageItem()`

Menampilkan item sebagai item gambar. Menampilkan pengecualian skrip jika ItemType belum berupa IMAGE.

Return

ImageItem — item gambar

Menampilkan

Error — jika item bukan item gambar

`asListItem()`

Menampilkan item sebagai item daftar. Menampilkan pengecualian skrip jika ItemType belum berupa LIST.

Return

ListItem — item daftar

Menampilkan

Error — jika item bukan item daftar

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

`asMultipleChoiceItem()`

Menampilkan item sebagai item pilihan ganda. Menampilkan pengecualian skrip jika ItemType belum berupa MULTIPLE_CHOICE.

Return

MultipleChoiceItem — item pilihan ganda

Menampilkan

Error — jika item bukan item pilihan ganda

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

`asPageBreakItem()`

Menampilkan item sebagai item jeda halaman. Menampilkan pengecualian skrip jika ItemType belum berupa PAGE_BREAK.

Return

PageBreakItem — item batas halaman

Menampilkan

Error — jika item bukan item batas halaman

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

`asParagraphTextItem()`

Menampilkan item sebagai item teks paragraf. Menampilkan pengecualian skrip jika ItemType belum berupa PARAGRAPH_TEXT.

Return

ParagraphTextItem — item teks paragraf

Menampilkan

Error — jika item bukan item teks paragraf

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

`asScaleItem()`

Menampilkan item sebagai item skala. Menampilkan pengecualian skrip jika ItemType belum berupa SCALE.

Return

ScaleItem — item skala

Menampilkan

Error — jika item bukan item skala

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

`asSectionHeaderItem()`

Menampilkan item sebagai item header bagian. Menampilkan pengecualian skrip jika ItemType belum berupa SECTION_HEADER.

Return

SectionHeaderItem — item header bagian

Menampilkan

Error — jika item bukan item header bagian

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

`asTextItem()`

Menampilkan item sebagai item teks. Menampilkan pengecualian skrip jika ItemType belum berupa TEXT.

Return

TextItem — item teks

Menampilkan

Error — jika item bukan item teks

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

`asTimeItem()`

Menampilkan item sebagai item waktu. Menampilkan pengecualian skrip jika ItemType belum berupa TIME.

Return

TimeItem — item waktu

Menampilkan

Error — jika item bukan item waktu

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

`asVideoItem()`

Menampilkan item sebagai item video. Menampilkan pengecualian skrip jika ItemType belum berupa VIDEO.

Return

VideoItem — item video

Menampilkan

Error — jika item bukan item video

`duplicate()`

Membuat salinan item ini dan menambahkannya ke akhir formulir.

Return

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

`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

`getTitle()`

Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Return

String — teks judul atau 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 ditampilkan 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

`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

Return

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

`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

Return

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