- แหล่งข้อมูล: แบบฟอร์ม
- ข้อมูล
- FormSettings
- การตั้งค่าแบบทดสอบ
- รายการ
- คําถามของรายการ
- คําถาม
- ตัวเลือกคําถาม
- ประเภททางเลือก
- ตัวเลือก
- การดําเนินการสิ่งที่ต้องทํา
- รูปภาพ
- คุณสมบัติของสื่อ
- การจัดแนว
- คําถามแบบข้อความ
- สเกลคําถาม
- วันที่ตั้งคําถาม
- คําถามด้านเวลา
- FileUploadQuestion
- ประเภทไฟล์
- คําถามแถว
- การให้คะแนน
- คําตอบที่ถูกต้อง
- คําตอบที่ถูกต้อง
- คําถามกลุ่มรายการ
- ตารางกริด
- รายการช่วงพักโฆษณา
- รายการข้อความ
- รายการรูปภาพ
- รายการวิดีโอ
- วิดีโอ
- เมธอด
ทรัพยากร: แบบฟอร์ม
เอกสาร Google ฟอร์ม ระบบจะสร้างแบบฟอร์มในไดรฟ์ ส่วนการลบแบบฟอร์มหรือเปลี่ยนการป้องกันการเข้าถึงจะทําผ่าน API ไดรฟ์
การแสดง JSON |
---|
{ "formId": string, "info": { object ( |
ช่อง | |
---|---|
formId |
เอาต์พุตเท่านั้น รหัสแบบฟอร์ม |
info |
ต้องระบุ ชื่อและคําอธิบายของแบบฟอร์ม |
settings |
การตั้งค่าของแบบฟอร์ม ต้องอัปเดตพร้อมกับ |
items[] |
ต้องระบุ รายการต่างๆ ในแบบฟอร์ม ซึ่งประกอบด้วยส่วนหัว คําถาม สื่อที่ฝังไว้ เป็นต้น |
revisionId |
เอาต์พุตเท่านั้น รหัสการแก้ไขของแบบฟอร์ม ใช้ใน รูปแบบของรหัสการแก้ไขอาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป ระบบจึงควรดําเนินการกับส่วนที่ทึบแสง เรารับประกันว่ารหัสการแก้ไขที่แสดงผลจะสามารถใช้งานได้ภายใน 24 ชั่วโมงหลังจากได้รับรหัสคืน และผู้ใช้ไม่สามารถแชร์ได้ หากรหัสการแก้ไขไม่เปลี่ยนแปลงระหว่างการเรียก แสดงว่าไม่มีการเปลี่ยนแปลงแบบฟอร์ม ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สําหรับแบบฟอร์มและผู้ใช้รายเดียวกัน) มักหมายความว่าแบบฟอร์มได้รับการอัปเดตแล้ว อย่างไรก็ตาม รหัสที่มีการเปลี่ยนแปลงอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส |
responderUri |
เอาต์พุตเท่านั้น URI ของแบบฟอร์มสําหรับแชร์กับผู้ตอบ ซึ่งจะเปิดหน้าที่ให้ผู้ใช้ส่งคําตอบได้แต่จะแก้ไขคําถามไม่ได้ |
linkedSheetId |
เอาต์พุตเท่านั้น รหัสของ Google ชีตที่ลิงก์ซึ่งรวบรวมคําตอบจากแบบฟอร์มนี้ (หากมีชีตดังกล่าว) |
ข้อมูล
ข้อมูลทั่วไปเกี่ยวกับแบบฟอร์ม
การแสดง JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
ช่อง | |
---|---|
title |
ต้องระบุ ชื่อแบบฟอร์มที่ผู้ตอบสามารถดูได้ |
documentTitle |
เอาต์พุตเท่านั้น ชื่อของเอกสารที่มองเห็นได้ในไดรฟ์ หาก |
description |
คําอธิบายของแบบฟอร์ม |
การตั้งค่าแบบฟอร์ม
การตั้งค่าแบบฟอร์ม
การแสดง JSON |
---|
{
"quizSettings": {
object ( |
ช่อง | |
---|---|
quizSettings |
การตั้งค่าที่เกี่ยวข้องกับแบบฟอร์มแบบทดสอบและการให้คะแนน |
การตั้งค่าแบบทดสอบ
การตั้งค่าที่เกี่ยวข้องกับแบบฟอร์มแบบทดสอบและการให้คะแนน ซึ่งข้อมูลเหล่านี้จะต้องอัปเดตกับ UpdateSettingsRequest
การแสดง JSON |
---|
{ "isQuiz": boolean } |
ช่อง | |
---|---|
isQuiz |
แบบฟอร์มนี้เป็นแบบทดสอบหรือไม่ เมื่อเป็นจริง ระบบจะให้คะแนนคําตอบจากคําถาม |
รายการ
แบบฟอร์มรายการเดียว kind
จะกําหนดประเภทของรายการ
การแสดง JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
ช่อง | |
---|---|
itemId |
รหัสสินค้า เมื่อสร้างได้ คุณต้องให้รหัสแต่ต้องไม่ใช้ ID นั้นในแบบฟอร์ม หากไม่ได้กําหนดไว้ ระบบจะกําหนดรหัสใหม่ให้ |
title |
ชื่อของสินค้า |
description |
คําอธิบายของรายการ |
ช่อง Union kind ต้องระบุ ชนิดของรายการนี้คือ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
questionItem |
ตั้งคําถามถึงผู้ใช้ |
questionGroupItem |
ตั้งคําถามอย่างน้อย 1 ข้อต่อผู้ใช้ด้วยข้อความแจ้งสําคัญเพียงข้อเดียว |
pageBreakItem |
เริ่มหน้าใหม่ที่มีชื่อ |
textItem |
แสดงชื่อและคําอธิบายบนหน้าเว็บ |
imageItem |
แสดงรูปภาพบนหน้า |
videoItem |
แสดงวิดีโอในหน้าเว็บ |
รายการคําถาม
รายการแบบฟอร์มที่มีคําถามเดียว
การแสดง JSON |
---|
{ "question": { object ( |
ช่อง | |
---|---|
question |
ต้องระบุ คําถามที่แสดง |
image |
รูปภาพที่แสดงในคําถาม |
คำถาม
คําถามเพิ่มเติม kind
จะทราบคําถามประเภทนี้
การแสดง JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
ช่อง | |
---|---|
questionId |
อ่านอย่างเดียว รหัสคําถาม เมื่อสร้างได้ คุณต้องให้รหัสแต่ต้องไม่ใช้ ID นั้นในแบบฟอร์ม หากไม่ได้กําหนดไว้ ระบบจะกําหนดรหัสใหม่ให้ |
required |
ต้องตอบคําถามหรือไม่เพื่อให้ผู้ตอบส่งคําตอบได้ |
grading |
การให้คะแนนการให้คะแนนสําหรับคําถาม |
ช่อง Union kind ต้องระบุ ประเภทของคําถามที่เสนอให้ผู้ตอบ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
choiceQuestion |
ผู้ตอบจะเลือกได้จากชุดตัวเลือกที่กําหนดไว้ล่วงหน้า |
textQuestion |
ผู้ตอบสามารถป้อนข้อความตอบกลับฟรี |
scaleQuestion |
ผู้ตอบจะเลือกตัวเลขจากช่วงได้ |
dateQuestion |
ผู้ตอบสามารถป้อนวันที่ |
timeQuestion |
ผู้ตอบสามารถป้อนเวลาได้ |
fileUploadQuestion |
ผู้ตอบสามารถอัปโหลดไฟล์อย่างน้อย 1 ไฟล์ |
rowQuestion |
แถวของ |
ตัวเลือกคําถาม
คําถามเกี่ยวกับวิทยุ/ช่องทําเครื่องหมาย/เมนูแบบเลื่อนลง
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ ประเภทของคําถามแบบเลือกตอบ |
options[] |
ต้องระบุ รายการตัวเลือกที่ผู้ตอบต้องเลือก |
shuffle |
ตัวเลือกควรแสดงในแบบสุ่มสําหรับอินสแตนซ์ต่างๆ ของแบบทดสอบหรือไม่ ซึ่งมักจะใช้ในการป้องกันการโกงจําเลยจากผู้ตอบที่อาจกําลังดูหน้าจอของผู้ตอบรายอื่น หรือเพื่อแก้ไขอคติในแบบสํารวจที่เกริ่นนําโดยใส่ตัวเลือกเดียวกันก่อนหรือท้ายสุด |
ประเภทตัวเลือก
ประเภทตัวเลือก
Enum | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้งาน |
RADIO |
ปุ่มตัวเลือก: ตัวเลือกทั้งหมดจะปรากฏต่อผู้ใช้ ซึ่งสามารถเลือกได้เพียงตัวเลือกเดียว |
CHECKBOX |
ช่องทําเครื่องหมาย: ตัวเลือกทั้งหมดจะแสดงแก่ผู้ใช้ซึ่งสามารถเลือกได้ไม่จํากัดจํานวน |
DROP_DOWN |
เมนูแบบเลื่อนลง: ตัวเลือกจะแสดงให้ผู้ใช้เห็นตามคําขอเท่านั้น ไม่เช่นนั้นจะแสดงเฉพาะตัวเลือกปัจจุบัน โดยเลือกได้เพียงตัวเลือกเดียว |
ตัวเลือก
ตัวเลือกสําหรับคําถามแบบตัวเลือก
การแสดง JSON |
---|
{ "value": string, "image": { object ( |
ช่อง | |
---|---|
value |
ต้องระบุ ตัวเลือกที่แสดงให้ผู้ใช้เห็น |
image |
แสดงรูปภาพเป็นตัวเลือก |
isOther |
ตัวเลือกคือ "อื่นๆ" ขณะนี้ใช้ได้กับตัวเลือกประเภท |
ช่อง Union go_to_section จะไปที่ส่วนใดหากเลือกตัวเลือกนี้ ปัจจุบันมีผลกับตัวเลือกประเภท RADIO และ SELECT เท่านั้น แต่ไม่อนุญาตให้ใช้ใน QuestionGroupItem go_to_section ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
goToAction |
ประเภทการนําทางส่วน |
goToSectionId |
รหัสรายการส่วนหัวของส่วนหัวที่จะไป |
การดําเนินการ
ค่าคงที่สําหรับการนําทางส่วน
Enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้งาน |
NEXT_SECTION |
ไปที่ส่วนถัดไป |
RESTART_FORM |
กลับไปยังจุดเริ่มต้นของแบบฟอร์ม |
SUBMIT_FORM |
ส่งแบบฟอร์มทันที |
รูปภาพ
ข้อมูลที่แสดงถึงรูปภาพ
การแสดง JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
ช่อง | |
---|---|
contentUri |
เอาต์พุตเท่านั้น URI ที่คุณสามารถดาวน์โหลดภาพได้ ใช้ภายในเวลาที่จํากัดเท่านั้น |
altText |
คําอธิบายของรูปภาพที่แสดงเมื่อวางเมาส์เหนือและอ่านโดยโปรแกรมอ่านหน้าจอ |
properties |
คุณสมบัติของรูปภาพ |
ช่อง Union image_source ชนิดของแหล่งที่มาของรูปภาพ ต้องตั้งค่าฟิลด์แหล่งที่มาของภาพหนึ่งช่องเมื่อสร้างภาพใหม่ image_source ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
sourceUri |
อินพุตเท่านั้น URI ต้นทางคือ URI ที่ใช้แทรกรูปภาพ URI แหล่งที่มาอาจว่างเปล่าเมื่อดึงข้อมูล |
คุณสมบัติของสื่อ
คุณสมบัติของสื่อ
การแสดง JSON |
---|
{
"alignment": enum ( |
ช่อง | |
---|---|
alignment |
ตําแหน่งของสื่อ |
width |
ความกว้างของสื่อเป็นพิกเซล เมื่อมีการแสดงสื่อ ระบบจะปรับขนาดสื่อให้มีขนาดเล็กลงของค่านี้หรือตามความกว้างของฟอร์มที่ปรากฏ อัตราส่วนเดิมของสื่อจะยังคงอยู่ หากไม่ได้ระบุความกว้างเมื่อเพิ่มสื่อในแบบฟอร์ม ระบบจะตั้งค่าเป็นความกว้างของแหล่งที่มาของสื่อ ความกว้างต้องอยู่ระหว่าง 0 ถึง 740 อนุญาตให้ใช้การตั้งค่าความกว้างเป็น 0 หรือไม่ได้ระบุเมื่ออัปเดตแหล่งที่มาของสื่อเท่านั้น |
การจัดข้อความ
การปรับแนวในหน้าเว็บ
Enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้งาน |
LEFT |
จัดข้อความชิดซ้าย |
RIGHT |
จัดข้อความชิดขวา |
CENTER |
กลาง |
คําถามแบบข้อความ
คําถามที่อิงตามข้อความ
การแสดง JSON |
---|
{ "paragraph": boolean } |
ช่อง | |
---|---|
paragraph |
ไม่ว่าคําถามจะเป็นคําถามย่อหน้าหรือไม่ก็ตาม ถ้าไม่ คําถามคือคําถามในรูปแบบข้อความสั้นๆ |
คําถามเกี่ยวกับมาตราส่วน
คําถามเกี่ยวกับการปรับขนาด ผู้ใช้มีช่วงของค่าตัวเลขให้เลือก
การแสดง JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
ช่อง | |
---|---|
low |
ต้องระบุ ค่าต่ําสุดที่เป็นไปได้สําหรับสเกล |
high |
ต้องระบุ ค่าสูงสุดที่เป็นไปได้สําหรับสเกล |
lowLabel |
ป้ายกํากับที่จะแสดงเพื่ออธิบายจุดต่ําสุดของสเกล |
highLabel |
ป้ายกํากับที่จะแสดงเพื่ออธิบายจุดสูงสุดบนสเกล |
วันที่ตั้งคําถาม
คําถามเกี่ยวกับวันที่ คําถามวันที่จะมีค่าเริ่มต้นเป็นเดือน + วัน
การแสดง JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
ช่อง | |
---|---|
includeTime |
ระบุเวลาเป็นส่วนหนึ่งของคําถามไหม |
includeYear |
ระบุว่าจะรวมปีเป็นส่วนหนึ่งของคําถามหรือไม่ |
คําถามเกี่ยวกับเวลา
คําถามเกี่ยวกับเวลา
การแสดง JSON |
---|
{ "duration": boolean } |
ช่อง | |
---|---|
duration |
|
คําถามอัปโหลดไฟล์
คําถามเกี่ยวกับการอัปโหลดไฟล์ ขณะนี้ API ไม่รองรับการสร้างคําถามในการอัปโหลดไฟล์
การแสดง JSON |
---|
{
"folderId": string,
"types": [
enum ( |
ช่อง | |
---|---|
folderId |
ต้องระบุ รหัสของโฟลเดอร์ไดรฟ์ที่ไฟล์ที่อัปโหลด |
types[] |
ประเภทไฟล์ที่ยอมรับโดยคําถามนี้ |
maxFiles |
จํานวนสูงสุดของไฟล์ที่อัปโหลดสําหรับคําถามนี้ได้ในการตอบกลับครั้งเดียว |
maxFileSize |
จํานวนไบต์สูงสุดที่อนุญาตสําหรับไฟล์เดียวที่อัปโหลดไปยังคําถามนี้ |
ประเภทไฟล์
ประเภทไฟล์ที่สามารถอัปโหลดไปยังคําถามการอัปโหลดไฟล์
Enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้งาน |
ANY |
ไม่มีข้อจํากัดเกี่ยวกับประเภท |
DOCUMENT |
เอกสาร Google เอกสาร |
PRESENTATION |
งานนําเสนอของ Google สไลด์ |
SPREADSHEET |
สเปรดชีตของ Google ชีต |
DRAWING |
ภาพวาด |
PDF |
ไฟล์ PDF |
IMAGE |
รูปภาพ |
VIDEO |
วิดีโอ |
AUDIO |
ไฟล์เสียง |
คําถามแถว
การกําหนดค่าสําหรับคําถามที่เป็นส่วนหนึ่งของกลุ่มคําถาม
การแสดง JSON |
---|
{ "title": string } |
ช่อง | |
---|---|
title |
ต้องระบุ ชื่อของแถวเดียวใน |
การให้คะแนน
การให้คะแนนคําถามเดียว
การแสดง JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
ช่อง | |
---|---|
pointValue |
ต้องระบุ จํานวนคะแนนสูงสุดที่ผู้ตอบจะได้รับโดยอัตโนมัติสําหรับคําตอบที่ถูกต้อง ค่านี้ต้องไม่เป็นค่าลบ |
correctAnswers |
ต้องระบุ เฉลยคําตอบของคําถาม ระบบจะให้คะแนนการตอบกลับโดยอัตโนมัติตามช่องนี้ |
whenRight |
ความคิดเห็นที่แสดงสําหรับคําตอบที่ถูกต้อง ตั้งค่าความคิดเห็นนี้สําหรับคําถามแบบหลายตัวเลือกที่มีคําตอบที่ถูกต้องเท่านั้น |
whenWrong |
ความคิดเห็นที่แสดงสําหรับคําตอบที่ไม่ถูกต้อง ตั้งค่าความคิดเห็นนี้สําหรับคําถามแบบหลายตัวเลือกที่มีคําตอบที่ถูกต้องเท่านั้น |
generalFeedback |
ความคิดเห็นที่แสดงสําหรับคําตอบทั้งหมด ซึ่งมักจะใช้สําหรับคําถามที่ต้องการคําตอบสั้นๆ เมื่อเจ้าของแบบทดสอบต้องการที่ให้ผู้ตอบจําได้อย่างรวดเร็วว่าสามารถตอบคําถามได้อย่างถูกต้องหรือไม่ก่อนที่จะสามารถให้เกรดคําตอบได้อย่างเป็นทางการ ไม่สามารถตั้งค่าความคิดเห็นทั่วไปสําหรับคําถามแบบหลายตัวเลือกที่มีการให้คะแนนอัตโนมัติ |
คําตอบที่ถูกต้อง
เฉลยคําตอบของคําถาม
การแสดง JSON |
---|
{
"answers": [
{
object ( |
ช่อง | |
---|---|
answers[] |
รายการคําตอบที่ถูกต้อง ระบบจะให้คะแนนคําตอบตอบกลับโดยอัตโนมัติโดยอิงจากคําตอบเหล่านี้ได้ สําหรับคําถามที่มีค่าเดียว ระบบจะทําเครื่องหมายว่าเป็นคําตอบที่ถูกต้องหากตรงกับค่าในรายการนี้ (กล่าวคือ มีคําตอบที่ถูกต้องหลายรายการ) สําหรับคําถามที่มีหลายค่า ( |
คําตอบที่ถูกต้อง
คําตอบเดียวที่ถูกต้องสําหรับคําถาม สําหรับคําถามที่มีหลายค่า (CHECKBOX
) อาจต้องใช้ CorrectAnswer
หลายรายการเพื่อแสดงตัวเลือกคําตอบที่ถูกต้องเพียงตัวเลือกเดียว
การแสดง JSON |
---|
{ "value": string } |
ช่อง | |
---|---|
value |
ต้องระบุ ค่าคําตอบที่ถูกต้อง โปรดดูรายละเอียดเกี่ยวกับวิธีจัดรูปแบบค่าประเภทต่างๆ ในเอกสารประกอบสําหรับ |
รายการคําถามของกลุ่ม
กําหนดคําถามที่ประกอบด้วยคําถามหลายข้อที่จัดอยู่ในกลุ่มเดียวกัน
การแสดง JSON |
---|
{ "questions": [ { object ( |
ช่อง | |
---|---|
questions[] |
ต้องระบุ รายการคําถามที่อยู่ในกลุ่มคําถามนี้ คําถามต้องอยู่ในกลุ่มเดียวเท่านั้น |
image |
รูปภาพที่แสดงภายในกลุ่มคําถามเหนือคําถามที่เฉพาะเจาะจง |
ช่อง Union kind ต้องระบุ ประเภทกลุ่มคําถามซึ่งจะเป็นตัวกําหนดประเภทคําถามที่อนุญาตและวิธีแสดงคําถาม kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
grid |
กลุ่มคําถามเป็นตารางกริดที่มีแถวคําถามแบบหลายตัวเลือกซึ่งใช้ตัวเลือกเดียวกัน เมื่อตั้งค่า |
GRid
ตารางตัวเลือก (ช่องวิทยุหรือช่องทําเครื่องหมาย) โดยแต่ละแถวจะประกอบด้วยคําถามแต่ละข้อ แต่ละแถวจะมีตัวเลือกเหมือนกันซึ่งแสดงเป็นคอลัมน์ต่างๆ
การแสดง JSON |
---|
{
"columns": {
object ( |
ช่อง | |
---|---|
columns |
ต้องระบุ ตัวเลือกที่คําถามแต่ละข้อแชร์ในตาราง กล่าวคือ ค่าของคอลัมน์ โดยเลือกได้ |
shuffleQuestions |
หากเป็น |
รายการตัวแบ่งหน้า
ตัวแบ่งหน้า ชื่อและคําอธิบายรายการนี้จะแสดงที่ด้านบนของหน้าใหม่
รายการข้อความ
รายการข้อความ
รายการภาพ
รายการที่มีรูปภาพ
การแสดง JSON |
---|
{
"image": {
object ( |
ช่อง | |
---|---|
image |
ต้องระบุ รูปภาพที่แสดงในสินค้า |
รายการวิดีโอ
รายการที่มีวิดีโอ
การแสดง JSON |
---|
{
"video": {
object ( |
ช่อง | |
---|---|
video |
ต้องระบุ วิดีโอที่แสดงในรายการ |
caption |
ข้อความที่ปรากฏใต้วิดีโอ |
วิดีโอ
ข้อมูลที่แสดงถึงวิดีโอ
การแสดง JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
ช่อง | |
---|---|
youtubeUri |
ต้องระบุ URI ของ YouTube |
properties |
คุณสมบัติของวิดีโอ |
วิธีการ |
|
---|---|
|
เปลี่ยนแบบฟอร์มเป็นกลุ่มการอัปเดต |
|
สร้างแบบฟอร์มใหม่โดยใช้ชื่อที่ระบุในข้อความแบบฟอร์มที่ให้ไว้ในคําขอ |
|
รับแบบฟอร์ม |