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