Class DateTimeItem

DateTimeItem

Item pertanyaan yang memungkinkan responden menunjukkan tanggal dan waktu. Item dapat diakses atau dibuat dari Form. Saat digunakan dalam kuis, item ini akan dinilai.

// Open a form by ID and add a new date-time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
createResponse(response)ItemResponseMembuat ItemResponse baru untuk item tanggal-waktu ini.
duplicate()DateTimeItemMembuat salinan item ini dan menambahkannya ke akhir formulir.
getGeneralFeedback()QuizFeedbackMenampilkan masukan yang ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai.
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.
getPoints()IntegerMenampilkan nilai poin item yang dapat dinilai.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item yang ditampilkan sebagai ItemType.
includesYear()BooleanMenentukan apakah item tanggal menyertakan opsi tahun.
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan.
setGeneralFeedback(feedback)DateTimeItemMenetapkan masukan untuk ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai yang tidak memiliki jawaban yang benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).
setHelpText(text)DateTimeItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemMenetapkan apakah item tanggal menyertakan setelan tahun.
setPoints(points)DateTimeItemMenetapkan jumlah poin yang bernilai untuk item yang dapat dinilai.
setRequired(enabled)DateTimeItemMenetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)DateTimeItemMenetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Dokumentasi mendetail

createResponse(response)

Membuat ItemResponse baru untuk item tanggal-waktu ini. Kolom detik objek Date diabaikan; secara default, kolom tahun, bulan, hari, jam, dan menit digunakan. Jika setIncludesYear(enabled) ditetapkan ke false, tahun juga akan diabaikan.

Parameter

NamaJenisDeskripsi
responseDateobjek Date yang mewakili bulan, hari, jam, menit, dan mungkin tahun

Return

ItemResponse — respons 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

duplicate()

Membuat salinan item ini dan menambahkannya ke akhir formulir.

Return

DateTimeItem — duplikat dari DateTimeItem 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

getGeneralFeedback()

Menampilkan masukan yang ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai.

Return

QuizFeedback — masukan, jika ada.

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

getPoints()

Menampilkan nilai poin item yang dapat dinilai.

Return

Integer — jumlah poin yang dimiliki sebuah pertanyaan.

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

Mendapatkan jenis item yang ditampilkan 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

includesYear()

Menentukan apakah item tanggal menyertakan opsi tahun.

Return

Booleantrue jika tanggal menyertakan setelan tahun; false jika tidak

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

isRequired()

Menentukan apakah responden harus menjawab pertanyaan.

Return

Boolean — apakah responden harus menjawab pertanyaan

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

setGeneralFeedback(feedback)

Menetapkan masukan untuk ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai yang tidak memiliki jawaban yang benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).

Parameter

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan yang baru

Return

DateTimeItemDateTimeItem 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

setHelpText(text)

Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Parameter

NamaJenisDeskripsi
textStringteks bantuan baru

Return

DateTimeItemDateTimeItem 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

setIncludesYear(enableYear)

Menetapkan apakah item tanggal menyertakan setelan tahun. Default untuk item tanggal baru adalah true.

Parameter

NamaJenisDeskripsi
enableYearBooleantrue jika tanggal menyertakan latar tahun; false jika tidak

Return

DateTimeItemDateTimeItem 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

setPoints(points)

Menetapkan jumlah poin yang bernilai untuk item yang dapat dinilai. Default untuk item baru adalah 0.

Parameter

NamaJenisDeskripsi
pointsIntegerjumlah poin yang bernilai dari item pertanyaan

Return

DateTimeItemDateTimeItem 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

setRequired(enabled)

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

NamaJenisDeskripsi
enabledBooleanapakah responden harus menjawab pertanyaan

Return

DateTimeItem — item saat 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

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

Return

DateTimeItemDateTimeItem 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