REST Resource: forms

แหล่งข้อมูล: แบบฟอร์ม

เอกสาร Google ฟอร์ม ระบบจะสร้างแบบฟอร์มในไดรฟ์ และการลบแบบฟอร์มหรือเปลี่ยนการป้องกันการเข้าถึงจะทําผ่าน Drive API

การแสดง JSON 
{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}
ช่อง
formId

string

เอาต์พุตเท่านั้น รหัสแบบฟอร์ม
info

object (Info)

ต้องระบุ ชื่อและคำอธิบายของแบบฟอร์ม
settings

object (FormSettings)

การตั้งค่าของแบบฟอร์ม ข้อมูลนี้ต้องอัปเดตด้วย UpdateSettingsRequest ระบบจะไม่สนใจข้อมูลนี้ระหว่าง forms.create และ UpdateFormInfoRequest
items[]

object (Item)

ต้องระบุ รายการรายการของแบบฟอร์ม ซึ่งอาจรวมถึงส่วนหัวของส่วน คําถาม สื่อที่ฝัง ฯลฯ
revisionId

string

เอาต์พุตเท่านั้น รหัสการแก้ไขของแบบฟอร์ม ใช้กับ WriteControl ในคำขออัปเดตเพื่อระบุการแก้ไขที่ใช้เป็นพื้นฐานของการเปลี่ยนแปลง

รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป จึงควรใช้รหัสดังกล่าวอย่างระมัดระวัง รหัสการแก้ไขที่แสดงจะใช้งานได้ภายใน 24 ชั่วโมงหลังจากแสดงเท่านั้น และไม่สามารถแชร์ระหว่างผู้ใช้ได้ หากรหัสการแก้ไขไม่เปลี่ยนแปลงระหว่างการเรียกใช้ แสดงว่าแบบฟอร์มไม่มีการเปลี่ยนแปลง ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สําหรับแบบฟอร์มและผู้ใช้เดียวกัน) มักจะหมายความว่ามีการอัปเดตแบบฟอร์ม อย่างไรก็ตาม รหัสที่เปลี่ยนแปลงอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส
responderUri

string

เอาต์พุตเท่านั้น URI ของแบบฟอร์มที่จะแชร์กับผู้ตอบ ซึ่งจะเปิดหน้าเว็บที่อนุญาตให้ผู้ใช้ส่งคำตอบได้ แต่จะแก้ไขคำถามไม่ได้
linkedSheetId

string

เอาต์พุตเท่านั้น รหัสของชีต Google ที่ลิงก์ซึ่งรวบรวมคําตอบจากแบบฟอร์มนี้ (หากมีชีตดังกล่าว)

ข้อมูล

ข้อมูลทั่วไปสำหรับแบบฟอร์ม

การแสดง JSON 
{
  "title": string,
  "documentTitle": string,
  "description": string
}
ช่อง
title

string

ต้องระบุ ชื่อของแบบฟอร์มที่ผู้ตอบจะเห็น
documentTitle

string

เอาต์พุตเท่านั้น ชื่อเอกสารที่แสดงในไดรฟ์ หาก Info.title ว่างเปล่า documentTitle อาจปรากฏแทนที่ใน UI ของ Google ฟอร์มและผู้ตอบจะเห็น documentTitle documentTitle สามารถตั้งค่าเมื่อสร้าง แต่แก้ไขด้วยคําขอ batchUpdate ไม่ได้ โปรดใช้ Google Drive API หากต้องการอัปเดต documentTitle ในโปรแกรม
description

string

คำอธิบายของแบบฟอร์ม

FormSettings

การตั้งค่าของแบบฟอร์ม

การแสดง JSON 
{
  "quizSettings": {
    object (QuizSettings)
  },
  "emailCollectionType": enum (EmailCollectionType)
}
ช่อง
quizSettings

object (QuizSettings)

การตั้งค่าที่เกี่ยวข้องกับแบบฟอร์มแบบทดสอบและการให้คะแนน
emailCollectionType

enum (EmailCollectionType)

ไม่บังคับ การตั้งค่าที่กำหนดว่าแบบฟอร์มจะรวบรวมอีเมลจากผู้ตอบหรือไม่

QuizSettings

การตั้งค่าที่เกี่ยวข้องกับแบบฟอร์มแบบทดสอบและการให้คะแนน โดยต้องอัปเดตด้วย UpdateSettingsRequest

การแสดง JSON 
{
  "isQuiz": boolean
}
ช่อง
isQuiz

boolean

ระบุว่าแบบฟอร์มนี้เป็นแบบทดสอบหรือไม่ เมื่อเป็น "จริง" ระบบจะให้คะแนนคำตอบตามคำถาม Grading เมื่อตั้งค่าเป็น "เท็จ" ระบบจะลบคำถาม Grading ทั้งหมด

EmailCollectionType

ไม่บังคับ การตั้งค่าที่กำหนดว่าแบบฟอร์มจะรวบรวมอีเมลจากผู้ตอบหรือไม่ และวิธีรวบรวมอีเมล หากแบบฟอร์มรวบรวมอีเมล ระบบจะป้อนค่าในช่อง formResponse.respondentEmail

Enum
EMAIL_COLLECTION_TYPE_UNSPECIFIED ไม่ระบุ ค่านี้ไม่ได้ใช้งาน
DO_NOT_COLLECT แบบฟอร์มไม่ได้รวบรวมอีเมล ค่าเริ่มต้นในกรณีที่เจ้าของแบบฟอร์มใช้บัญชี Google
VERIFIED แบบฟอร์มจะรวบรวมอีเมลโดยอัตโนมัติตามบัญชีของผู้ใช้ที่ลงชื่อเข้าใช้ ค่าเริ่มต้นในกรณีที่เจ้าของแบบฟอร์มใช้บัญชี Google Workspace
RESPONDER_INPUT แบบฟอร์มจะรวบรวมอีเมลโดยใช้ช่องที่ผู้ตอบกรอกข้อมูลในแบบฟอร์ม

รายการ

รายการเดียวของแบบฟอร์ม kind จะกำหนดประเภทของสินค้า

การแสดง JSON 
{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}
ช่อง
itemId

string

รหัสสินค้า

คุณสามารถระบุรหัสได้เมื่อสร้าง แต่ต้องไม่มีการใช้รหัสนั้นในแบบฟอร์มอยู่แล้ว หากไม่ได้ระบุ ระบบจะกําหนดรหัสใหม่
title

string

ชื่อของสินค้า
description

string

คำอธิบายของสินค้า
ฟิลด์สหภาพ kind ต้องระบุ ประเภทของรายการ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
questionItem

object (QuestionItem)

ถามคำถามผู้ใช้
questionGroupItem

object (QuestionGroupItem)

ถามคำถามอย่างน้อย 1 ข้อแก่ผู้ใช้ด้วยพรอมต์หลักรายการเดียว
pageBreakItem

object (PageBreakItem)

เริ่มหน้าใหม่ที่มีชื่อ
textItem

object (TextItem)

แสดงชื่อและคําอธิบายในหน้า
imageItem

object (ImageItem)

แสดงรูปภาพในหน้าเว็บ
videoItem

object (VideoItem)

แสดงวิดีโอในหน้าเว็บ

QuestionItem

รายการแบบฟอร์มที่มีคําถามเดียว

การแสดง JSON 
{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}
ช่อง
question

object (Question)

ต้องระบุ คำถามที่แสดง
image

object (Image)

รูปภาพที่แสดงภายในคำถาม

คำถาม

หากมีคำถาม คำถามประเภทหนึ่งๆ จะเรียกว่า kind

การแสดง JSON 
{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  },
  "ratingQuestion": {
    object (RatingQuestion)
  }
  // End of list of possible types for union field kind.
}
ช่อง
questionId

string

อ่านอย่างเดียว รหัสคำถาม

คุณสามารถระบุรหัสได้เมื่อสร้าง แต่ต้องไม่มีการใช้รหัสนั้นในแบบฟอร์มอยู่แล้ว หากไม่ได้ระบุ ระบบจะกําหนดรหัสใหม่
required

boolean

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

object (Grading)

การตั้งค่าการให้คะแนนสำหรับคำถาม
ฟิลด์สหภาพ kind ต้องระบุ ประเภทคำถามที่เสนอให้ผู้ตอบ kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
choiceQuestion

object (ChoiceQuestion)

ผู้ตอบจะเลือกจากชุดตัวเลือกที่กําหนดไว้ล่วงหน้าได้
textQuestion

object (TextQuestion)

ผู้ตอบสามารถป้อนคำตอบที่เป็นข้อความอิสระได้
scaleQuestion

object (ScaleQuestion)

ผู้ตอบจะเลือกตัวเลขจากช่วงได้
dateQuestion

object (DateQuestion)

ผู้ตอบสามารถป้อนวันที่ได้
timeQuestion

object (TimeQuestion)

ผู้ตอบสามารถป้อนเวลาได้
fileUploadQuestion

object (FileUploadQuestion)

ผู้ตอบสามารถอัปโหลดไฟล์ได้อย่างน้อย 1 ไฟล์
rowQuestion

object (RowQuestion)

แถวของ QuestionGroupItem
ratingQuestion

object (RatingQuestion)

ผู้ตอบสามารถเลือกคะแนนจากชุดไอคอนที่กําหนดไว้ล่วงหน้า

ChoiceQuestion

คำถามแบบปุ่มตัวเลือก/ช่องทำเครื่องหมาย/เมนูแบบเลื่อนลง

การแสดง JSON 
{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}
ช่อง
type

enum (ChoiceType)

ต้องระบุ ประเภทของคำถามแบบเลือก
options[]

object (Option)

ต้องระบุ รายการตัวเลือกที่ผู้ตอบต้องเลือก
shuffle

boolean

ตัวเลือกควรแสดงตามลำดับแบบสุ่มสำหรับอินสแตนซ์แบบต่างๆ ของแบบทดสอบหรือไม่ มักใช้เพื่อป้องกันการโกงจากผู้ตอบที่อาจกลอกดูหน้าจอของผู้ตอบคนอื่นๆ หรือเพื่อแก้ไขความลำเอียงในแบบสํารวจที่อาจเกิดขึ้นจากการใส่ตัวเลือกเดียวกันไว้เป็นตัวเลือกแรกหรือสุดท้ายเสมอ

ChoiceType

ประเภทของตัวเลือก

Enum
CHOICE_TYPE_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
RADIO ปุ่มตัวเลือก: ระบบจะแสดงตัวเลือกทั้งหมดต่อผู้ใช้ ซึ่งผู้ใช้จะเลือกได้เพียงตัวเลือกเดียว
CHECKBOX ช่องทําเครื่องหมาย: ระบบจะแสดงตัวเลือกทั้งหมดต่อผู้ใช้ ซึ่งสามารถเลือกตัวเลือกได้เท่าใดก็ได้
DROP_DOWN เมนูแบบเลื่อนลง: ตัวเลือกจะแสดงต่อผู้ใช้เมื่อมีการเรียกใช้เท่านั้น ไม่เช่นนั้นระบบจะแสดงเฉพาะตัวเลือกปัจจุบัน โดยเลือกได้เพียงตัวเลือกเดียว

ตัวเลือก

ตัวเลือกสำหรับคำถามแบบเลือก

การแสดง JSON 
{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}
ช่อง
value

string

ต้องระบุ ตัวเลือกที่แสดงต่อผู้ใช้
image

object (Image)

แสดงรูปภาพเป็นตัวเลือก
isOther

boolean

ตัวเลือกเป็น "อื่นๆ" หรือไม่ ปัจจุบันใช้ได้กับตัวเลือกประเภท RADIO และ CHECKBOX เท่านั้น แต่ไม่ใช้ใน QuestionGroupItem ได้
ฟิลด์สหภาพ go_to_section ส่วนที่จะไปที่หากเลือกตัวเลือกนี้ ปัจจุบันใช้ได้กับประเภทตัวเลือก RADIO และ SELECT เท่านั้น แต่ไม่อนุญาตให้ใช้ใน QuestionGroupItem go_to_section ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
goToAction

enum (GoToAction)

ประเภทการนําทางส่วน
goToSectionId

string

รหัสรายการของส่วนหัวที่จะไปยัง

GoToAction

ค่าคงที่สำหรับการนําทางส่วน

Enum
GO_TO_ACTION_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
NEXT_SECTION ไปที่ส่วนถัดไป
RESTART_FORM กลับไปที่จุดเริ่มต้นของแบบฟอร์ม
SUBMIT_FORM ส่งแบบฟอร์มทันที

รูปภาพ

ข้อมูลที่แสดงรูปภาพ

การแสดง JSON 
{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}
ช่อง
contentUri

string

เอาต์พุตเท่านั้น URI ที่คุณใช้ดาวน์โหลดรูปภาพได้ ซึ่งจะใช้ได้ในช่วงเวลาที่จำกัดเท่านั้น
altText

string

คำอธิบายรูปภาพที่แสดงเมื่อวางเมาส์เหนือและอ่านโดยโปรแกรมอ่านหน้าจอ
properties

object (MediaProperties)

คุณสมบัติของรูปภาพ
ฟิลด์สหภาพ image_source ประเภทแหล่งที่มาของรูปภาพ คุณต้องตั้งค่าฟิลด์แหล่งที่มาของรูปภาพเพียง 1 ฟิลด์เท่านั้นเมื่อสร้างรูปภาพใหม่ image_source ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sourceUri

string

อินพุตเท่านั้น URI ต้นทางคือ URI ที่ใช้แทรกรูปภาพ URI แหล่งที่มาอาจว่างเปล่าเมื่อดึงข้อมูล

MediaProperties

พร็อพเพอร์ตี้ของสื่อ

การแสดง JSON 
{
  "alignment": enum (Alignment),
  "width": integer
}
ช่อง
alignment

enum (Alignment)

ตำแหน่งของสื่อ
width

integer

ความกว้างของสื่อเป็นพิกเซล เมื่อแสดงสื่อ ระบบจะปรับขนาดสื่อให้เล็กกว่าค่านี้หรือความกว้างของแบบฟอร์มที่แสดง ระบบจะคงสัดส่วนภาพของสื่อต้นฉบับไว้ หากไม่ได้ระบุความกว้างเมื่อเพิ่มสื่อลงในแบบฟอร์ม ระบบจะตั้งค่าความกว้างเป็นความกว้างของแหล่งที่มาของสื่อ ความกว้างต้องอยู่ระหว่าง 0 ถึง 740 เท่านั้น การตั้งค่าความกว้างเป็น 0 หรือไม่ได้ระบุจะอนุญาตเฉพาะเมื่ออัปเดตแหล่งที่มาของสื่อเท่านั้น

การจัดข้อความ

การจัดวางในหน้า

Enum
ALIGNMENT_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
LEFT จัดชิดซ้าย
RIGHT จัดชิดขวา
CENTER กลาง

TextQuestion

คำถามแบบข้อความ

การแสดง JSON 
{
  "paragraph": boolean
}
ช่อง
paragraph

boolean

คำถามเป็นคำถามแบบย่อหน้าหรือไม่ หากไม่มี แสดงว่าคำถามเป็นคำถามแบบข้อความสั้น

ScaleQuestion

คำถามแบบมาตราส่วน ผู้ใช้มีช่วงค่าตัวเลขให้เลือก

การแสดง JSON 
{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}
ช่อง
low

integer

ต้องระบุ ค่าต่ำสุดที่เป็นไปได้สำหรับรูปแบบ
high

integer

ต้องระบุ ค่าสูงสุดที่เป็นไปได้สำหรับรูปแบบการให้คะแนน
lowLabel

string

ป้ายกำกับที่จะแสดงเพื่ออธิบายจุดต่ำสุดบนสเกล
highLabel

string

ป้ายกำกับที่จะแสดงเพื่ออธิบายจุดสูงสุดบนมาตราส่วน

DateQuestion

คำถามเกี่ยวกับวันที่ คำถามเกี่ยวกับวันที่จะมีค่าเริ่มต้นเป็นเดือน + วันเท่านั้น

การแสดง JSON 
{
  "includeTime": boolean,
  "includeYear": boolean
}
ช่อง
includeTime

boolean

ใส่เวลาเป็นส่วนหนึ่งของคำถามหรือไม่
includeYear

boolean

ระบุหรือไม่ว่าให้รวมปีไว้ในคำถาม

TimeQuestion

คำถามเกี่ยวกับเวลา

การแสดง JSON 
{
  "duration": boolean
}
ช่อง
duration

boolean

true หากคำถามเกี่ยวกับเวลาผ่านไป มิเช่นนั้น จะเป็นข้อมูลเกี่ยวกับช่วงเวลาของวัน

FileUploadQuestion

คำถามที่ให้อัปโหลดไฟล์ ปัจจุบัน API ไม่รองรับการสร้างคำถามการอัปโหลดไฟล์

การแสดง JSON 
{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}
ช่อง
folderId

string

ต้องระบุ รหัสของโฟลเดอร์ในไดรฟ์ที่จัดเก็บไฟล์ที่อัปโหลด
types[]

enum (FileType)

ประเภทไฟล์ที่คำถามนี้ยอมรับ
maxFiles

integer

จำนวนไฟล์สูงสุดที่อัปโหลดสำหรับคำถามนี้ได้ในการตอบกลับครั้งเดียว
maxFileSize

string (int64 format)

จำนวนไบต์สูงสุดที่อนุญาตสำหรับไฟล์เดียวที่อัปโหลดไปยังคำถามนี้

FileType

ประเภทไฟล์ที่อัปโหลดไปยังคำถามที่อัปโหลดไฟล์ได้

Enum
FILE_TYPE_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
ANY ไม่มีข้อจำกัดด้านประเภท
DOCUMENT เอกสาร Google เอกสาร
PRESENTATION งานนำเสนอ Google สไลด์
SPREADSHEET สเปรดชีต Google ชีต
DRAWING ภาพวาด
PDF PDF
IMAGE รูปภาพ
VIDEO วิดีโอ
AUDIO ไฟล์เสียง

RowQuestion

การกําหนดค่าสําหรับคําถามที่เป็นส่วนหนึ่งของกลุ่มคําถาม

การแสดง JSON 
{
  "title": string
}
ช่อง
title

string

ต้องระบุ ชื่อของแถวเดียวใน QuestionGroupItem

RatingQuestion

คำถามการให้คะแนน ผู้ใช้มีไอคอนให้เลือกมากมาย

การแสดง JSON 
{
  "ratingScaleLevel": integer,
  "iconType": enum (RatingIconType)
}
ช่อง
ratingScaleLevel

integer

ต้องระบุ ระดับสเกลการให้คะแนนของคำถามการให้คะแนน
iconType

enum (RatingIconType)

ต้องระบุ ประเภทไอคอนที่จะใช้สำหรับการจัดประเภท

RatingIconType

ประเภทไอคอนที่จะใช้สำหรับการจัดประเภท

Enum
RATING_ICON_TYPE_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
STAR ไอคอนดาว
HEART ไอคอนหัวใจ
THUMB_UP ไอคอนไม่ชอบ

การให้คะแนน

การให้คะแนนสำหรับคำถามเดียว

การแสดง JSON 
{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}
ช่อง
pointValue

integer

ต้องระบุ จำนวนคะแนนสูงสุดที่ผู้ตอบจะได้รับโดยอัตโนมัติสำหรับคำตอบที่ถูกต้อง ค่านี้ต้องไม่ติดลบ
correctAnswers

object (CorrectAnswers)

ต้องระบุ เฉลยของคำถาม ระบบจะให้คะแนนคำตอบโดยอัตโนมัติตามช่องนี้
whenRight

object (Feedback)

ความคิดเห็นที่แสดงสำหรับคำตอบที่ถูกต้อง คุณสามารถตั้งค่าความคิดเห็นนี้สำหรับคำถามแบบหลายตัวเลือกที่มีคำตอบที่ถูกต้องเท่านั้น
whenWrong

object (Feedback)

ความคิดเห็นที่แสดงสำหรับคำตอบที่ไม่ถูกต้อง คุณสามารถตั้งค่าความคิดเห็นนี้สำหรับคำถามแบบหลายตัวเลือกที่มีคำตอบที่ถูกต้องเท่านั้น
generalFeedback

object (Feedback)

ความคิดเห็นที่แสดงสำหรับคำตอบทั้งหมด ฟีเจอร์นี้มักใช้กับคำถามแบบคำตอบสั้นๆ เมื่อเจ้าของแบบทดสอบต้องการแจ้งให้ผู้ตอบทราบอย่างรวดเร็วว่าตอบคำถามถูกต้องหรือไม่ก่อนที่จะมีเวลาให้คะแนนคำตอบอย่างเป็นทางการ ตั้งค่าความคิดเห็นทั่วไปสำหรับคำถามแบบปรนัยที่ให้คะแนนโดยอัตโนมัติไม่ได้

CorrectAnswers

เฉลยของคำถาม

การแสดง JSON 
{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}
ช่อง
answers[]

object (CorrectAnswer)

รายการคำตอบที่ถูกต้อง ระบบจะให้คะแนนคำตอบของแบบทดสอบโดยอัตโนมัติตามคำตอบเหล่านี้ สำหรับคำถามที่มีค่าเดียว ระบบจะทําเครื่องหมายคำตอบว่าถูกต้องหากตรงกับค่าใดก็ได้ในรายการนี้ (กล่าวคือ อาจมีคำตอบที่ถูกต้องหลายรายการ) สำหรับคำถามที่มีค่าหลายรายการ (CHECKBOX) ระบบจะทําเครื่องหมายคำตอบว่าถูกต้องหากคำตอบมีค่าในรายการนี้ตรงกันทุกประการ

CorrectAnswer

คำตอบที่ถูกต้องเพียงคำตอบเดียวสำหรับคำถามหนึ่งๆ สำหรับคำถามที่มีค่าหลายค่า (CHECKBOX) คุณอาจต้องใช้ CorrectAnswer หลายรายการเพื่อแสดงตัวเลือกคำตอบที่ถูกต้องรายการเดียว

การแสดง JSON 
{
  "value": string
}
ช่อง
value

string

ต้องระบุ ค่าคำตอบที่ถูกต้อง ดูรายละเอียดเกี่ยวกับการจัดรูปแบบค่าประเภทต่างๆ ได้ในเอกสารประกอบของ TextAnswer.value

QuestionGroupItem

กําหนดคําถามที่ประกอบด้วยคําถามหลายข้อที่จัดกลุ่มไว้ด้วยกัน

การแสดง JSON 
{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}
ช่อง
questions[]

object (Question)

ต้องระบุ รายการคำถามที่อยู่ในกลุ่มคำถามนี้ คำถามต้องอยู่ในกลุ่มเดียวเท่านั้น kind ของกลุ่มอาจส่งผลต่อประเภทคำถามที่อนุญาต
image

object (Image)

รูปภาพที่แสดงภายในกลุ่มคำถามเหนือคำถามที่เฉพาะเจาะจง
ฟิลด์สหภาพ kind ต้องระบุ ประเภทของกลุ่มคำถาม ซึ่งจะเป็นตัวกำหนดประเภทคำถามที่อนุญาตและวิธีแสดงคำถาม kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
grid

object (Grid)

กลุ่มคำถามคือตารางกริดที่มีแถวของคำถามแบบหลายตัวเลือกที่ใช้ตัวเลือกเดียวกัน เมื่อตั้งค่าเป็น grid คำถามทั้งหมดในกลุ่มต้องเป็นประเภท row

GRid

ตารางตัวเลือก (ช่องทำเครื่องหมายหรือช่องตัวเลือก) โดยแต่ละแถวจะเป็นคำถามแยกกัน แต่ละแถวจะมีตัวเลือกเดียวกันซึ่งแสดงเป็นคอลัมน์

การแสดง JSON 
{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}
ช่อง
columns

object (ChoiceQuestion)

ต้องระบุ ตัวเลือกที่แชร์โดยคำถามแต่ละข้อในตารางกริด กล่าวคือ ค่าของคอลัมน์ อนุญาตให้เลือกได้เฉพาะ CHECK_BOX และ RADIO
shuffleQuestions

boolean

หากเป็น true ระบบจะสุ่มเรียงลำดับคำถาม กล่าวคือ แถวจะปรากฏในลําดับที่ต่างกันสําหรับผู้ตอบทุกคน

PageBreakItem

ประเภทนี้ไม่มีช่อง

ตัวแบ่งหน้า ชื่อและคําอธิบายของรายการนี้จะแสดงที่ด้านบนของหน้าใหม่

TextItem

ประเภทนี้ไม่มีช่อง

รายการข้อความ

ImageItem

รายการที่มีรูปภาพ

การแสดง JSON 
{
  "image": {
    object (Image)
  }
}
ช่อง
image

object (Image)

ต้องระบุ รูปภาพที่แสดงในรายการ

VideoItem

รายการที่มีวิดีโอ

การแสดง JSON 
{
  "video": {
    object (Video)
  },
  "caption": string
}
ช่อง
video

object (Video)

ต้องระบุ วิดีโอที่แสดงในสินค้า
caption

string

ข้อความที่แสดงใต้วิดีโอ

วิดีโอ

ข้อมูลที่แสดงถึงวิดีโอ

การแสดง JSON 
{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}
ช่อง
youtubeUri

string

ต้องระบุ URI ของ YouTube
properties

object (MediaProperties)

พร็อพเพอร์ตี้ของวิดีโอ

เมธอด

batchUpdate

 เปลี่ยนแบบฟอร์มด้วยการอัปเดตหลายรายการพร้อมกัน

create

 สร้างแบบฟอร์มใหม่โดยใช้ชื่อที่ให้ไว้ในข้อความแบบฟอร์มที่ระบุในคำขอ

get

 รับแบบฟอร์ม