Item formulir generik yang berisi properti yang 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
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 batas 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 bagian 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 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 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 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 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 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 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()
asListItem()
Menampilkan item sebagai item daftar. Menampilkan pengecualian pembuatan skrip jika ItemType
belum 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 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 batas halaman. Menampilkan pengecualian pembuatan skrip jika ItemType
belum PAGE_BREAK
.
Pulang pergi
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 pembuatan skrip jika ItemType
belum 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
asScaleItem()
Menampilkan item sebagai item skala. Menampilkan pengecualian pembuatan skrip jika ItemType
belum SCALE
.
Pulang pergi
ScaleItem
— item timbangan
Menampilkan
Error
— jika item bukan item timbangan
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 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 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 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()
duplicate()
Membuat salinan item ini dan menambahkannya ke bagian akhir formulir.
Pulang pergi
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
).
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()
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 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
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 |
Pulang pergi
Item
— Item
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