REST Resource: forms

{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}

string

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

object (Info)

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

object (FormSettings)

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

object (Item)

ต้องระบุ รายการของแบบฟอร์ม ซึ่งอาจรวมถึงส่วนหัวของส่วน คำถาม สื่อที่ฝัง เป็นต้น

string

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

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

string

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

string

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

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

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

string

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

string

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

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

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

{
  "isQuiz": boolean
}

boolean

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

{
  "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.
}

string

รหัสสินค้า

สามารถระบุได้ในขั้นตอนการสร้าง แต่ต้องไม่ใช้รหัสในแบบฟอร์มอยู่แล้ว หากไม่ระบุ ระบบจะกำหนดรหัสใหม่

string

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

string

คำอธิบายของรายการ

object (QuestionItem)

โพสต์คำถามไปยังผู้ใช้

object (QuestionGroupItem)

ตั้งคำถามกับผู้ใช้ด้วยข้อความแจ้งหลักเพียงคำถามเดียว

object (PageBreakItem)

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

object (TextItem)

แสดงชื่อและคำอธิบายในหน้าเว็บ

object (ImageItem)

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

object (VideoItem)

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

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

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

object (Image)

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

{
  "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)
  }
  // End of list of possible types for union field kind.
}

string

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

สามารถระบุได้ในขั้นตอนการสร้าง แต่ต้องไม่ใช้รหัสในแบบฟอร์มอยู่แล้ว หากไม่ระบุ ระบบจะกำหนดรหัสใหม่

boolean

ต้องตอบคำถามเพื่อให้ผู้ตอบส่งคำตอบได้หรือไม่

object (Grading)

การตั้งค่าการให้คะแนนสำหรับคำถาม

object (ChoiceQuestion)

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

object (TextQuestion)

ผู้ตอบสามารถป้อนข้อความได้อย่างอิสระ

object (ScaleQuestion)

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

object (DateQuestion)

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

object (TimeQuestion)

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

object (FileUploadQuestion)

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

object (RowQuestion)

แถวของ QuestionGroupItem

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

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

object (Option)

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

boolean

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

{
  "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.
}

string

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

object (Image)

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

boolean

ตัวเลือกเป็น "อื่นๆ" หรือไม่ ขณะนี้ใช้ได้กับตัวเลือกประเภท RADIO และ CHECKBOX เท่านั้น แต่ยังไม่อนุญาตให้ใช้ใน QuestionGroupItem

enum (GoToAction)

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

string

รหัสรายการในส่วนหัวของส่วน

{
  "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.
}

string

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

string

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

object (MediaProperties)

คุณสมบัติของรูปภาพ

string

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

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

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

integer

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

{
  "paragraph": boolean
}

boolean

คําถามเป็นคําถามที่เป็นย่อหน้าหรือไม่ หากไม่ใช่ คำถามจะเป็นคำถามแบบข้อความสั้นๆ

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

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

integer

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

string

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

string

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

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

ระบุเวลาในคำถามหรือไม่

boolean

ต้องการรวมปีเป็นส่วนหนึ่งของคำถามหรือไม่

{
  "duration": boolean
}

boolean

true หากคําถามเกี่ยวกับเวลาที่ผ่านไป หรือไม่เช่นนั้นก็ประมาณช่วงเวลาของวัน

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

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

enum (FileType)

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

integer

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

string (int64 format)

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

{
  "title": string
}

string

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

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

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

object (CorrectAnswers)

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

object (Feedback)

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

object (Feedback)

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

object (Feedback)

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

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

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

{
  "value": string
}

string

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

{
  "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.
}

object (Question)

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

object (Image)

รูปภาพที่แสดงภายในกลุ่มคำถามอยู่เหนือคำถามที่เจาะจง

object (Grid)

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

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

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

boolean

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

{
  "image": {
    object (Image)
  }
}

object (Image)

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

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

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

string

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

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

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

object (MediaProperties)

คุณสมบัติของวิดีโอ