รายการคำถามที่ให้ผู้ตอบเลือกตัวเลือกเดียวจากรายการปุ่มตัวเลือก หรือช่อง "อื่นๆ" (ไม่บังคับ) เข้าถึงหรือสร้างรายการจาก Form
ได้ เมื่อใช้ในแบบทดสอบ ระบบจะตรวจคำตอบเหล่านี้โดยอัตโนมัติ
// Open a form by ID and add a new multiple choice item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]) .showOtherOption(true);
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
create | Choice | สร้างตัวเลือกใหม่ |
create | Choice | สร้างตัวเลือกใหม่ |
create | Choice | สร้างทางเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้าเว็บซึ่งจะข้ามไปยังรายการการแบ่งหน้าที่กำหนด |
create | Choice | สร้างตัวเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้า |
create | Item | สร้าง Item ใหม่สำหรับรายการตัวเลือกหลายรายการนี้ |
duplicate() | Multiple | สร้างสําเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม |
get | Choice[] | รับตัวเลือกทั้งหมดสำหรับสินค้า |
get | Quiz | แสดงผลความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง |
get | Quiz | แสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง |
get | String | รับข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น Image , Page และ Section ) |
get | Integer | รับตัวระบุที่ไม่ซ้ำกันของรายการ |
get | Integer | รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม |
get | Integer | แสดงผลคะแนนของงานที่มีคะแนน |
get | String | รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ Section ) |
get | Item | รับประเภทของรายการซึ่งแสดงเป็น Item |
has | Boolean | ระบุว่ารายการมีตัวเลือก "อื่นๆ" หรือไม่ |
is | Boolean | กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่ |
set | Multiple | ตั้งค่าตัวเลือกสำหรับรายการจากอาร์เรย์สตริง |
set | Multiple | ตั้งค่าอาร์เรย์ตัวเลือกสําหรับสินค้า |
set | Multiple | ตั้งค่าการแสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง |
set | Multiple | ตั้งค่าให้แสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง |
set | Multiple | ตั้งค่าข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น Image , Page และ Section ) |
set | Multiple | กำหนดจำนวนคะแนนของงานที่ให้คะแนนได้ |
set | Multiple | ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่ |
set | Multiple | ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ Section ) |
show | Multiple | กำหนดว่ารายการจะมีตัวเลือก "อื่นๆ" หรือไม่ |
เอกสารประกอบโดยละเอียด
create Choice(value)
สร้างตัวเลือกใหม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | String | ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม |
รีเทิร์น
Choice
— ตัวเลือกใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
create Choice(value, isCorrect)
สร้างตัวเลือกใหม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | String | ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม |
is | Boolean | ตัวเลือกเป็นคำตอบที่ถูกต้องหรือไม่ |
รีเทิร์น
Choice
— ตัวเลือกใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
create Choice(value, navigationItem)
สร้างทางเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้าเว็บซึ่งจะข้ามไปยังรายการการแบ่งหน้าที่กำหนด การดำเนินการนี้เทียบเท่ากับ create
ซึ่งตั้งค่า navigation
เป็น Form
ตัวเลือกที่ใช้การนําทางด้านหน้าจะรวมไว้ในรายการเดียวกันกับตัวเลือกที่ไม่ใช้การนําทางด้านหน้าไม่ได้
การนําทางหน้าเว็บจะเกิดขึ้นหลังจากที่ผู้ตอบตอบหน้าเว็บที่มีตัวเลือกนั้นเสร็จสิ้นแล้ว และในกรณีที่ผู้ตอบเลือกตัวเลือกนั้นเท่านั้น หากผู้ตอบเลือกตัวเลือกหลายรายการที่มีวิธีการไปยังส่วนต่างๆ ของหน้าในหน้าเดียวกัน จะมีผลเฉพาะตัวเลือกการไปยังส่วนต่างๆ รายการล่าสุดเท่านั้น นอกจากนี้ การไปยังส่วนต่างๆ ของหน้าเว็บจะไม่มีผลกับหน้าสุดท้ายของแบบฟอร์ม
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | String | ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม |
navigation | Page | รายการที่จะไปยัง |
รีเทิร์น
Choice
— ตัวเลือกใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
create Response(response)
สร้าง Item
ใหม่สำหรับรายการตัวเลือกหลายรายการนี้ ยกเว้นข้อยกเว้นหากอาร์กิวเมนต์ response
ไม่ตรงกับตัวเลือกที่ถูกต้องสำหรับรายการนี้ เว้นแต่จะมีการตั้งค่า show
เป็น true
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
response | String | คำตอบที่ถูกต้องสำหรับรายการแบบหลายตัวเลือกนี้ |
รีเทิร์น
Item
— การตอบกลับรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
สร้างสําเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม
รีเทิร์น
Multiple
— รายการ Multiple
รายการนี้ซ้ำกันสำหรับใช้ต่อท้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Choices()
get Feedback For Correct()
แสดงผลความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง
รีเทิร์น
Quiz
— ความคิดเห็น (หากมี)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Feedback For Incorrect()
แสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง
รีเทิร์น
Quiz
— ความคิดเห็น (หากมี)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
รับข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น Image
, Page
และ Section
)
รีเทิร์น
String
— ข้อความความช่วยเหลือหรือข้อความอธิบายของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
รับตัวระบุที่ไม่ซ้ำกันของรายการ
รีเทิร์น
Integer
— รหัสของสินค้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม
รีเทิร์น
Integer
— ดัชนีของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Points()
แสดงผลคะแนนของงานที่มีคะแนน
รีเทิร์น
Integer
— จํานวนคะแนนของคําถาม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Title()
รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ Section
)
รีเทิร์น
String
— ชื่อหรือข้อความส่วนหัวของสินค้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
has Other Option()
ระบุว่ารายการมีตัวเลือก "อื่นๆ" หรือไม่
รีเทิร์น
Boolean
— true
หากรายการมีตัวเลือก "อื่นๆ" false
หากไม่มี
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
is Required()
กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
รีเทิร์น
Boolean
— ผู้ตอบต้องตอบคำถามหรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Choice Values(values)
ตั้งค่าตัวเลือกสำหรับรายการจากอาร์เรย์สตริง โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่า
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | String[] | อาร์เรย์ของค่าตัวเลือกที่ผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Choices(choices)
ตั้งค่าอาร์เรย์ตัวเลือกสําหรับสินค้า โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่าหรือมีองค์ประกอบ null
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
choices | Choice[] | ตัวเลือกมากมาย |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
โยน
Error
— หากอาร์เรย์ที่ระบุเป็น null
ว่าง หรือมีองค์ประกอบ null
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Feedback For Correct(feedback)
ตั้งค่าการแสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false), ]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(), );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
feedback | Quiz | ความคิดเห็นใหม่ ค่า Null จะล้างความคิดเห็น |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Feedback For Incorrect(feedback)
ตั้งค่าให้แสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
feedback | Quiz | ความคิดเห็นใหม่ |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
ตั้งค่าข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น Image
, Page
และ Section
)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความช่วยเหลือใหม่ |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
กำหนดจำนวนคะแนนของงานที่ให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
points | Integer | จำนวนคะแนนของรายการคำถาม |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | ผู้ตอบต้องตอบคำถามหรือไม่ |
รีเทิร์น
Multiple
— รายการปัจจุบัน (สำหรับการต่อเชื่อม)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ Section
)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | ชื่อหรือข้อความส่วนหัวใหม่ |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
show Other Option(enabled)
กำหนดว่ารายการจะมีตัวเลือก "อื่นๆ" หรือไม่ ค่าเริ่มต้นของ Checkbox
หรือ Multiple
ใหม่คือ false
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากสินค้ามีตัวเลือก "อื่นๆ" false หากไม่มี |
รีเทิร์น
Multiple
— Multiple
นี้สําหรับการเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms