Interface Item

Item

Item formulir generik yang berisi properti umum 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

NamaDeskripsi singkat

Metode

MetodeJenis nilai 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 jeda halaman.
asParagraphTextItem()ParagraphTextItemMenampilkan item sebagai item teks paragraf.
asRatingItem()RatingItemMenampilkan item sebagai item rating.
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, 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 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 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 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 skrip jika ItemType belum DATETIME.

Pulang pergi

DateTimeItem — item tanggal dan waktu

Menampilkan

Error — jika item bukan item tanggal dan 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 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 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 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 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 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 jeda halaman. Menampilkan pengecualian skrip jika ItemType belum PAGE_BREAK.

Pulang pergi

PageBreakItem — item jeda 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 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

asRatingItem()

Menampilkan item sebagai item rating. Menampilkan ScriptingException jika ItemType belum 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 skrip jika ItemType belum 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 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 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 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 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 akhir formulir.

Pulang pergi

Item — duplikat dari Item ini, untuk dirangkaikan

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 item atau teks header

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

Item — Item ini, untuk dirangkaikan

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 header baru

Pulang pergi

Item — Item ini, untuk dirangkaikan

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