Halaman ini diterjemahkan oleh Cloud Translation API.

Interface Item

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

Untuk mengoperasikan 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.
const form = FormApp.create('Form Name');
form.addTextItem();

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

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const 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.
`asRatingItem()`	`RatingItem`	Menampilkan item sebagai item rating.
`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 direpresentasikan 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 pembuatan skrip jika ItemType belum menjadi CHECKBOX_GRID.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi CHECKBOX.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi DATE.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi DATETIME.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi DURATION.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi GRID.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi IMAGE.

Pulang pergi

ImageItem — item gambar

Menampilkan

Error — jika item bukan item gambar

`asListItem()`

Menampilkan item sebagai item daftar. Menampilkan pengecualian pembuatan skrip jika ItemType belum menjadi LIST.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi MULTIPLE_CHOICE.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi PAGE_BREAK.

Pulang pergi

PageBreakItem — item batas halaman

Menampilkan

Error — jika item bukan item jeda 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 pembuatan skrip jika ItemType belum menjadi PARAGRAPH_TEXT.

Pulang pergi

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

`asRatingItem()`

Menampilkan item sebagai item rating. Menampilkan ScriptingException jika ItemType belum menjadi RATING.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

Pulang pergi

RatingItem — Item rating.

Menampilkan

Error — jika item bukan item rating

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 pembuatan skrip jika ItemType belum menjadi SCALE.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi SECTION_HEADER.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi TEXT.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi TIME.

Pulang pergi

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 pembuatan skrip jika ItemType belum menjadi VIDEO.

Pulang pergi

VideoItem — item video

Menampilkan

Error — jika item bukan item video

`duplicate()`

Membuat salinan item ini dan menambahkannya ke akhir formulir.

Pulang pergi

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

`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

`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

`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

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

Pulang pergi

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