REST Resource: forms

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

string

Chỉ có đầu ra. Mã biểu mẫu.

object (Info)

Bắt buộc. Tiêu đề và nội dung mô tả của biểu mẫu.

object (FormSettings)

Chế độ cài đặt của biểu mẫu. Bạn phải cập nhật lớp này bằng UpdateSettingsRequest; thì dữ liệu này sẽ bị bỏ qua trong forms.create và UpdateFormInfoRequest.

object (Item)

Bắt buộc. Danh sách các mục của biểu mẫu, có thể bao gồm tiêu đề mục, câu hỏi, phương tiện được nhúng, v.v.

string

Chỉ có đầu ra. Mã bản sửa đổi của biểu mẫu. Dùng trong WriteControl trong các yêu cầu cập nhật để xác định bản sửa đổi chứa các thay đổi.

Định dạng của mã bản sửa đổi có thể thay đổi theo thời gian, vì vậy, bạn nên sử dụng định dạng này không rõ ràng. Mã bản sửa đổi được trả về chỉ được đảm bảo là có hiệu lực trong vòng 24 giờ sau khi được trả về và không thể chia sẻ cho nhiều người dùng. Nếu mã sửa đổi không thay đổi giữa các lệnh gọi thì biểu mẫu sẽ không thay đổi. Ngược lại, mã nhận dạng đã thay đổi (cho cùng một biểu mẫu và người dùng) thường có nghĩa là biểu mẫu đã được cập nhật; tuy nhiên, giấy tờ tuỳ thân đã thay đổi cũng có thể do các yếu tố nội bộ, chẳng hạn như việc thay đổi định dạng của giấy tờ tuỳ thân.

string

Chỉ có đầu ra. URI biểu mẫu để chia sẻ với người trả lời. Thao tác này sẽ mở ra một trang cho phép người dùng gửi câu trả lời nhưng không chỉnh sửa câu hỏi.

string

Chỉ có đầu ra. Mã nhận dạng của Google Trang tính được liên kết đang tích luỹ câu trả lời từ Biểu mẫu này (nếu có một Trang tính như vậy).

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

string

Bắt buộc. Tiêu đề của biểu mẫu mà người trả lời nhìn thấy.

string

Chỉ có đầu ra. Tiêu đề của tài liệu hiển thị trong Drive. Nếu Info.title trống, documentTitle có thể xuất hiện ở vị trí của nó trong giao diện người dùng của Google Biểu mẫu và hiển thị với người trả lời. Bạn có thể thiết lập documentTitle khi tạo nhưng không thể sửa đổi bằng yêu cầu BulkUpdate. Vui lòng sử dụng API Google Drive nếu bạn cần cập nhật documentTitle theo phương thức lập trình.

string

Nội dung mô tả về biểu mẫu.

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

object (QuizSettings)

Các chế độ cài đặt liên quan đến biểu mẫu và cách chấm điểm của bài kiểm tra.

{
  "isQuiz": boolean
}

boolean

Biểu mẫu này có phải là bài kiểm tra hay không. Nếu đúng, các câu trả lời sẽ được chấm điểm dựa trên câu hỏi Grading. Khi bạn đặt thành false, mọi câu hỏi Grading sẽ bị xoá.

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

Mã mặt hàng.

Khi tạo, bạn có thể cung cấp mã này nhưng chưa sử dụng mã nhận dạng đó trong biểu mẫu. Nếu không được cung cấp, hệ thống sẽ chỉ định một mã nhận dạng mới.

string

Tiêu đề của mặt hàng.

string

Nội dung mô tả mặt hàng.

object (QuestionItem)

Đặt câu hỏi cho người dùng.

object (QuestionGroupItem)

Đặt một hoặc nhiều câu hỏi cho người dùng bằng một câu lệnh chính.

object (PageBreakItem)

Bắt đầu trang mới bằng tiêu đề.

object (TextItem)

Hiện tiêu đề và nội dung mô tả trên trang.

object (ImageItem)

Hiển thị hình ảnh trên trang.

object (VideoItem)

Hiển thị video trên trang.

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

object (Question)

Bắt buộc. Câu hỏi được hiển thị.

object (Image)

Hình ảnh xuất hiện trong câu hỏi.

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

Chỉ có thể đọc. Mã câu hỏi.

Khi tạo, bạn có thể cung cấp mã này nhưng chưa sử dụng mã nhận dạng đó trong biểu mẫu. Nếu không được cung cấp, hệ thống sẽ chỉ định một mã nhận dạng mới.

boolean

Liệu câu hỏi có phải được trả lời để người trả lời có thể gửi câu trả lời của họ hay không.

object (Grading)

Thiết lập cách chấm điểm cho câu hỏi.

object (ChoiceQuestion)

Người trả lời có thể chọn trong số một tập hợp các lựa chọn được xác định trước.

object (TextQuestion)

Người trả lời có thể nhập câu trả lời bằng văn bản tuỳ ý.

object (ScaleQuestion)

Người trả lời có thể chọn một số trong một phạm vi.

object (DateQuestion)

Người trả lời có thể nhập ngày.

object (TimeQuestion)

Người trả lời có thể nhập thời gian.

object (FileUploadQuestion)

Người trả lời có thể tải một hoặc nhiều tệp lên.

object (RowQuestion)

Một hàng của QuestionGroupItem.

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

enum (ChoiceType)

Bắt buộc. Loại câu hỏi lựa chọn.

object (Option)

Bắt buộc. Danh sách các phương án mà người trả lời phải chọn.

boolean

Liệu các lựa chọn có hiển thị theo thứ tự ngẫu nhiên cho nhiều trường hợp của bài kiểm tra hay không. Chức năng này thường dùng để ngăn chặn hành vi gian lận của người trả lời, những người có thể đang nhìn vào màn hình của người trả lời khác hoặc để xử lý thành kiến trong cuộc khảo sát có thể được đưa ra bằng cách luôn đặt cùng một lựa chọn trước hoặc cuối.

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

Bắt buộc. Lựa chọn như được hiển thị cho người dùng.

object (Image)

Hiển thị hình ảnh dưới dạng một lựa chọn.

boolean

Liệu lựa chọn có phải là "khác". Hiện chỉ áp dụng cho các loại lựa chọn RADIO và CHECKBOX, nhưng không được phép trong QuestionGroupItem.

enum (GoToAction)

Loại điều hướng mục.

string

Mã mục của tiêu đề mục cần chuyển đến.

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

Chỉ có đầu ra. URI mà từ đó bạn có thể tải hình ảnh xuống; điều này chỉ hợp lệ trong một khoảng thời gian có hạn.

string

Nội dung mô tả hình ảnh hiển thị khi trình đọc màn hình di chuột và đọc.

object (MediaProperties)

Thuộc tính của hình ảnh.

string

Chỉ nhập. URI nguồn là URI dùng để chèn hình ảnh. URI nguồn có thể trống khi được tìm nạp.

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

enum (Alignment)

Vị trí của nội dung nghe nhìn.

integer

Chiều rộng của nội dung nghe nhìn tính bằng pixel. Khi hiển thị, nội dung nghe nhìn sẽ được điều chỉnh theo tỷ lệ nhỏ hơn của giá trị này hoặc chiều rộng của biểu mẫu được hiển thị. Tỷ lệ khung hình gốc của nội dung nghe nhìn vẫn được giữ nguyên. Nếu bạn không chỉ định chiều rộng khi thêm nội dung nghe nhìn vào biểu mẫu, thì chiều rộng sẽ được đặt thành chiều rộng của nguồn nội dung nghe nhìn. Chiều rộng phải nằm trong khoảng từ 0 đến 740. Bạn chỉ được phép đặt chiều rộng thành 0 hoặc không chỉ định khi cập nhật nguồn của nội dung nghe nhìn.

{
  "paragraph": boolean
}

boolean

Xem câu hỏi có phải là câu hỏi dạng đoạn văn hay không. Nếu không, câu hỏi sẽ là một câu hỏi văn bản ngắn.

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

integer

Bắt buộc. Giá trị thấp nhất có thể cho thang đo.

integer

Bắt buộc. Giá trị cao nhất có thể cho thang.

string

Nhãn để hiển thị mô tả điểm thấp nhất trên thang đo.

string

Nhãn để hiển thị mô tả điểm cao nhất trên thang đo.

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

boolean

Liệu có đưa thời gian vào trong câu hỏi hay không.

boolean

Liệu có đưa năm vào trong câu hỏi hay không.

{
  "duration": boolean
}

boolean

true nếu câu hỏi về một khoảng thời gian đã trôi qua. Nếu không thì đó là khoảng thời gian trong ngày.

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

string

Bắt buộc. Mã nhận dạng của thư mục trên Drive lưu trữ các tệp đã tải lên.

enum (FileType)

Những loại tệp được câu hỏi này chấp nhận.

integer

Số lượng tệp tối đa có thể tải lên cho câu hỏi này trong một câu trả lời.

string (int64 format)

Số byte tối đa được phép đối với mọi tệp riêng lẻ được tải lên câu hỏi này.

{
  "title": string
}

string

Bắt buộc. Tiêu đề của một hàng trong QuestionGroupItem.

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

integer

Bắt buộc. Số điểm tối đa mà người trả lời có thể tự động nhận được cho một câu trả lời đúng. Giá trị này không được là số âm.

object (CorrectAnswers)

Bắt buộc. Đáp án cho câu hỏi. Các câu trả lời được tự động chấm điểm dựa trên trường này.

object (Feedback)

Phản hồi được hiển thị cho câu trả lời chính xác. Bạn chỉ có thể đặt phản hồi này cho những câu hỏi trắc nghiệm có câu trả lời đúng.

object (Feedback)

Thông tin phản hồi xuất hiện đối với những câu trả lời không chính xác. Bạn chỉ có thể đặt phản hồi này cho những câu hỏi trắc nghiệm có câu trả lời đúng.

object (Feedback)

Phản hồi được hiển thị cho tất cả câu trả lời. Phương pháp này thường dùng cho các câu hỏi có câu trả lời ngắn khi chủ sở hữu bài kiểm tra muốn nhanh chóng cho người trả lời biết liệu họ đã trả lời đúng câu hỏi hay chưa trước khi có cơ hội chấm điểm chính thức cho câu trả lời. Không thể đặt phản hồi chung cho các câu hỏi trắc nghiệm được chấm điểm tự động.

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

object (CorrectAnswer)

Danh sách các câu trả lời đúng. Câu trả lời của bài kiểm tra có thể được tự động chấm điểm dựa trên các câu trả lời này. Đối với các câu hỏi một giá trị, câu trả lời được đánh dấu là chính xác nếu khớp với bất kỳ giá trị nào trong danh sách này (nói cách khác, có thể có nhiều câu trả lời đúng). Đối với những câu hỏi có nhiều giá trị (CHECKBOX), câu trả lời sẽ được đánh dấu là chính xác nếu câu trả lời đó chứa chính xác các giá trị trong danh sách này.

{
  "value": string
}

string

Bắt buộc. Giá trị cho câu trả lời đúng. Hãy xem tài liệu về TextAnswer.value để biết thông tin chi tiết về cách định dạng các loại giá trị.

{
  "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)

Bắt buộc. Danh sách các câu hỏi thuộc nhóm câu hỏi này. Một câu hỏi chỉ được thuộc một nhóm. kind của nhóm này có thể ảnh hưởng đến loại câu hỏi được phép đặt.

object (Image)

Hình ảnh xuất hiện trong nhóm câu hỏi phía trên các câu hỏi cụ thể.

object (Grid)

Nhóm câu hỏi là một lưới gồm các hàng câu hỏi trắc nghiệm có cùng lựa chọn. Khi bạn đặt grid, tất cả câu hỏi trong nhóm phải thuộc loại row.

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

object (ChoiceQuestion)

Bắt buộc. Các phương án được chia sẻ cho từng câu hỏi trong lưới. Nói cách khác, đó là giá trị của các cột. Chỉ được phép lựa chọn CHECK_BOX và RADIO.

boolean

Nếu giá trị là true, các câu hỏi sẽ được sắp xếp ngẫu nhiên. Nói cách khác, các hàng xuất hiện theo thứ tự khác nhau đối với mỗi người trả lời.

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

object (Image)

Bắt buộc. Hình ảnh xuất hiện trong mục.

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

object (Video)

Bắt buộc. Video xuất hiện trong mục.

string

Văn bản xuất hiện bên dưới video.

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

string

Bắt buộc. URI YouTube.

object (MediaProperties)

Thuộc tính của video.