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