Interface Item

Item

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

NamaDeskripsi singkat

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
asCheckboxGridItem()CheckboxGridItemMenampilkan item sebagai item petak kotak centang.
asCheckboxItem()CheckboxItemMenampilkan item sebagai item kotak centang.
asDateItem()DateItemMenampilkan item sebagai item tanggal.
asDateTimeItem()DateTimeItemMenampilkan item sebagai item tanggal-waktu.
asDurationItem()DurationItemMenampilkan item sebagai item durasi.
asGridItem()GridItemMenampilkan item sebagai item petak.
asImageItem()ImageItemMenampilkan item sebagai item gambar.
asListItem()ListItemMenampilkan item sebagai item daftar.
asMultipleChoiceItem()MultipleChoiceItemMenampilkan item sebagai item pilihan ganda.
asPageBreakItem()PageBreakItemMenampilkan item sebagai item batas halaman.
asParagraphTextItem()ParagraphTextItemMenampilkan item sebagai item teks paragraf.
asScaleItem()ScaleItemMenampilkan item sebagai item skala.
asSectionHeaderItem()SectionHeaderItemMenampilkan item sebagai item header bagian.
asTextItem()TextItemMenampilkan item sebagai item teks.
asTimeItem()TimeItemMenampilkan item sebagai item waktu.
asVideoItem()VideoItemMenampilkan item sebagai item video.
duplicate()ItemMembuat salinan item ini dan menambahkannya ke bagian akhir formulir.
getHelpText()StringMendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
getId()IntegerMendapatkan ID unik item.
getIndex()IntegerMendapatkan indeks item di antara semua item dalam formulir.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
setHelpText(text)ItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setTitle(title)ItemMenetapkan 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()

Menampilkan item sebagai item gambar. Menampilkan pengecualian pembuatan skrip jika ItemType belum 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 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()

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

Pulang pergi

VideoItem — item video

Menampilkan

Error — jika item bukan item video


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

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

NamaJenisDeskripsi
textStringteks bantuan baru

Pulang pergi

ItemItem 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

NamaJenisDeskripsi
titleStringjudul atau teks {i>header <i}baru

Pulang pergi

ItemItem 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