Class DateTimeItem

วันที่เวลารายการ

รายการคำถามที่ช่วยให้ผู้ตอบระบุวันที่และเวลาได้ เข้าถึงหรือสร้างรายการได้จาก Form เมื่อใช้ในแบบทดสอบ ระบบจะให้คะแนนรายการเหล่านี้ 

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
createResponse(response)ItemResponseสร้าง ItemResponse ใหม่สำหรับรายการวันที่และเวลานี้
duplicate()DateTimeItemสร้างสำเนาของรายการนี้และต่อท้ายแบบฟอร์ม
getGeneralFeedback()QuizFeedback|nullแสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามที่ให้คะแนนได้
getHelpText()Stringรับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคำอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
getId()Integerรับตัวระบุที่ไม่ซ้ำกันของรายการ
getIndex()Integerรับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม
getPoints()Integerแสดงค่าคะแนนของรายการที่ให้คะแนนได้
getTitle()Stringรับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัวในกรณีของ SectionHeaderItem)
getType()ItemTypeรับประเภทของรายการ ซึ่งแสดงเป็น ItemType
includesYear()Booleanกำหนดว่ารายการวันที่จะมีตัวเลือกปีหรือไม่
isRequired()Booleanกำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setGeneralFeedback(feedback)DateTimeItemกำหนดความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามที่ให้คะแนนได้ซึ่ง ไม่มีคำตอบที่ถูกต้องหรือไม่ถูกต้อง (เช่น คำถามที่ต้องให้คะแนนด้วยตนเอง)
setHelpText(text)DateTimeItemตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
setIncludesYear(enableYear)DateTimeItemกำหนดว่ารายการวันที่มีการตั้งค่าปีหรือไม่
setPoints(points)DateTimeItemกำหนดจำนวนคะแนนของรายการที่ให้คะแนนได้
setRequired(enabled)DateTimeItemกำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setTitle(title)DateTimeItemตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัวในกรณีของ SectionHeaderItem)

เอกสารโดยละเอียด

createResponse(response)

สร้าง ItemResponse ใหม่สำหรับรายการวันที่และเวลานี้ ระบบจะไม่สนใจช่องวินาทีของออบเจ็กต์ Date โดยค่าเริ่มต้น ระบบจะใช้ช่องปี เดือน วัน ชั่วโมง และนาที หากตั้งค่า setIncludesYear(enabled) เป็น false ระบบจะ ไม่สนใจปีด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
responseDateออบเจ็กต์ Date ที่แสดงเดือน วัน ชั่วโมง นาที และอาจเป็นปี

รีเทิร์น

ItemResponse - คำตอบของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

สร้างสำเนาของรายการนี้และต่อท้ายแบบฟอร์ม

รีเทิร์น

DateTimeItem - สำเนาของ DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGeneralFeedback()

แสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามที่ให้คะแนนได้

รีเทิร์น

QuizFeedback|null - ความคิดเห็น (หากมี)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

รับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคำอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)

รีเทิร์น

String - ข้อความช่วยเหลือหรือข้อความคำอธิบายของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

รับตัวระบุที่ไม่ซ้ำกันของรายการ

รีเทิร์น

Integer — รหัสของสินค้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม

รีเทิร์น

Integer — ดัชนีของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPoints()

แสดงค่าคะแนนของรายการที่ให้คะแนนได้

รีเทิร์น

Integer - คะแนนเต็มของคำถาม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัวในกรณีของ SectionHeaderItem)

รีเทิร์น

String - ชื่อหรือข้อความส่วนหัวของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

รับประเภทของรายการ ซึ่งแสดงเป็น ItemType

รีเทิร์น

ItemType — ประเภทของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

includesYear()

กำหนดว่ารายการวันที่จะมีตัวเลือกปีหรือไม่

รีเทิร์น

Boolean — true หากวันที่มีการตั้งค่าปี false หากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isRequired()

กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่

รีเทิร์น

Boolean — ผู้ตอบแบบสอบถามต้องตอบคำถามหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGeneralFeedback(feedback)

กำหนดความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามที่ให้คะแนนได้ซึ่ง ไม่มีคำตอบที่ถูกต้องหรือไม่ถูกต้อง (เช่น คำถามที่ต้องให้คะแนนด้วยตนเอง)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
feedbackQuizFeedbackความคิดเห็นใหม่

รีเทิร์น

DateTimeItem — DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความช่วยเหลือใหม่

รีเทิร์น

DateTimeItem — DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setIncludesYear(enableYear)

กำหนดว่ารายการวันที่มีการตั้งค่าปีหรือไม่ ค่าเริ่มต้นสำหรับรายการวันที่ใหม่คือ true

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enableYearBooleantrue หากวันที่มีการตั้งค่าปี false หากไม่มี

รีเทิร์น

DateTimeItem — DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setPoints(points)

กำหนดจำนวนคะแนนของรายการที่ให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0

พารามิเตอร์

ชื่อประเภทคำอธิบาย
pointsIntegerจำนวนคะแนนของคำถาม

รีเทิร์น

DateTimeItem — DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleanผู้ตอบแบบสอบถามต้องตอบคำถามหรือไม่

รีเทิร์น

DateTimeItem — รายการปัจจุบัน (สำหรับการเชื่อมโยง)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัวในกรณีของ SectionHeaderItem)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringข้อความชื่อหรือข้อความส่วนหัวใหม่

รีเทิร์น

DateTimeItem — DateTimeItem นี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms