Interface Item

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
Item

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

Untuk beroperasi pada 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

NameDeskripsi 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 waktu tanggal.
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 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, untuk 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, untuk SectionHeaderItem).

Dokumentasi mendetail

asCheckboxGridItem()

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

Return

CheckboxGridItem — item petak 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

asCheckboxItem()

Menampilkan item sebagai item kotak centang. Menampilkan pengecualian skrip jika ItemType belum menjadi 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 menjadi 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 waktu tanggal. Menampilkan pengecualian skrip jika ItemType belum menjadi DATETIME.

Return

DateTimeItem — item waktu tanggal

Menampilkan

Error — jika item bukan item waktu 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

asDurationItem()

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

Return

DurationItem — item durasi

Menampilkan

Error — jika item bukan merupakan 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 menjadi 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 menjadi IMAGE.

Return

ImageItem — item gambar

Menampilkan

Error — jika item bukan item gambar


asListItem()

Menampilkan item sebagai item daftar. Menampilkan pengecualian skrip jika ItemType belum menjadi 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 menjadi MULTIPLE_CHOICE.

Return

MultipleChoiceItem — item pilihan ganda

Menampilkan

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

Return

ParagraphTextItem — item teks paragraf

Menampilkan

Error — jika item bukan merupakan 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 menjadi 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 menjadi 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 menjadi 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 menjadi 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 menjadi 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, untuk SectionHeaderItem).

Return

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.

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

NameJenisDeskripsi
textStringteks bantuan baru

Return

Item — ini Item, untuk rantai

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, untuk SectionHeaderItem).

Parameter

NameJenisDeskripsi
titleStringjudul atau teks header baru

Return

Item — ini Item, untuk rantai

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