- Tài nguyên: Biểu mẫu
- Thông tin
- FormSettings
- QuizSettings
- EmailCollectionType
- Mặt hàng
- QuestionItem
- Câu hỏi
- ChoiceQuestion
- ChoiceType
- Tuỳ chọn
- GoToAction
- Hình ảnh
- MediaProperties
- Căn chỉnh
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- RatingQuestion
- RatingIconType
- Điểm số
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Lưới
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- PublishSettings
- PublishState
- Phương thức
Tài nguyên: Biểu mẫu
Tài liệu trên Google Biểu mẫu. Biểu mẫu được tạo trong Drive và bạn có thể xoá hoặc thay đổi biện pháp bảo vệ quyền truy cập vào biểu mẫu đó thông qua API Drive.
Biểu diễn dưới dạng JSON |
---|
{ "formId": string, "info": { object ( |
Trường | |
---|---|
formId |
Chỉ có đầu ra. Mã biểu mẫu. |
info |
Bắt buộc. Tiêu đề và nội dung mô tả của biểu mẫu. |
settings |
Chế độ cài đặt của biểu mẫu. Bạn phải cập nhật giá trị này bằng |
items[] |
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, nội dung nghe nhìn được nhúng, v.v. |
revisionId |
Chỉ có đầu ra. Mã bản sửa đổi của biểu mẫu. Được dùng trong Đị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 xử lý mã này một cách không rõ ràng. Mã sửa đổi được trả về chỉ được đảm bảo hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ giữa các người dùng. Nếu mã sửa đổi không thay đổi giữa các lệnh gọi, thì nội dung của biểu mẫu cũng không thay đổi. Ngược lại, mã đã thay đổi (cho cùng một biểu mẫu và người dùng) thường có nghĩa là nội dung của biểu mẫu đã được cập nhật; tuy nhiên, mã đã thay đổi cũng có thể là do các yếu tố nội bộ, chẳng hạn như thay đổi định dạng mã. Nội dung biểu mẫu không bao gồm siêu dữ liệu biểu mẫu, bao gồm:
|
responderUri |
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. Đối với các biểu mẫu đã đặt giá trị |
linkedSheetId |
Chỉ có đầu ra. Mã của Google Trang tính được liên kết đang tích luỹ các câu trả lời từ Biểu mẫu này (nếu có Trang tính như vậy). |
publishSettings |
Chỉ có đầu ra. Chế độ cài đặt xuất bản cho một biểu mẫu. Trường này không được đặt cho các biểu mẫu cũ vì các biểu mẫu này không có trường Các biểu mẫu có giá trị |
Thông tin
Thông tin chung về một biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Trường | |
---|---|
title |
Bắt buộc. Tiêu đề của biểu mẫu mà người trả lời nhìn thấy. |
documentTitle |
Chỉ có đầu ra. Tiêu đề của tài liệu xuất hiện trong Drive. Nếu |
description |
Nội dung mô tả biểu mẫu. |
FormSettings
Chế độ cài đặt của biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "quizSettings": { object ( |
Trường | |
---|---|
quizSettings |
Các chế độ cài đặt liên quan đến bài kiểm tra và việc chấm điểm. |
emailCollectionType |
Không bắt buộc. Chế độ cài đặt xác định xem biểu mẫu có thu thập địa chỉ email của người trả lời hay không. |
QuizSettings
Các chế độ cài đặt liên quan đến bài kiểm tra và việc chấm điểm. Bạn phải cập nhật các giá trị này bằng UpdateSettingsRequest.
Biểu diễn dưới dạng JSON |
---|
{ "isQuiz": boolean } |
Trường | |
---|---|
isQuiz |
Liệu biểu mẫu này có phải là bài kiểm tra hay không. Khi giá trị này là đúng, câu trả lời sẽ được chấm điểm dựa trên câu hỏi |
EmailCollectionType
Không bắt buộc. Chế độ cài đặt xác định xem biểu mẫu có thu thập địa chỉ email của người trả lời hay không và cách thu thập địa chỉ email. Nếu biểu mẫu thu thập địa chỉ email, thì các giá trị sẽ được điền vào trường formResponse.respondentEmail
.
Enum | |
---|---|
EMAIL_COLLECTION_TYPE_UNSPECIFIED |
Không xác định. Giá trị này không được sử dụng. |
DO_NOT_COLLECT |
Biểu mẫu không thu thập địa chỉ email. Giá trị mặc định nếu chủ sở hữu biểu mẫu sử dụng Tài khoản Google. |
VERIFIED |
Biểu mẫu này tự động thu thập địa chỉ email dựa trên tài khoản của người dùng đã đăng nhập. Giá trị mặc định nếu chủ sở hữu biểu mẫu sử dụng tài khoản Google Workspace. |
RESPONDER_INPUT |
Biểu mẫu thu thập địa chỉ email bằng một trường mà người trả lời điền vào biểu mẫu. |
Mục
Một mục duy nhất của biểu mẫu. kind
xác định loại mặt hàng đó.
Biểu diễn dưới dạng JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Trường | |
---|---|
itemId |
Mã mặt hàng. Bạn có thể cung cấp mã này khi tạo, nhưng mã này không được trùng với mã đã dùng trong biểu mẫu. Nếu bạn không cung cấp, hệ thống sẽ chỉ định một mã nhận dạng mới. |
title |
Tiêu đề của mặt hàng. |
description |
Nội dung mô tả mặt hàng. |
Trường hợp hợp nhất kind . Bắt buộc. Loại mục này. kind chỉ có thể là một trong những loại sau: |
|
questionItem |
Đặt câu hỏi cho người dùng. |
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. |
pageBreakItem |
Bắt đầu một trang mới có tiêu đề. |
textItem |
Hiển thị tiêu đề và nội dung mô tả trên trang. |
imageItem |
Hiển thị hình ảnh trên trang. |
videoItem |
Hiển thị một video trên trang. |
QuestionItem
Một mục biểu mẫu chứa một câu hỏi.
Biểu diễn dưới dạng JSON |
---|
{ "question": { object ( |
Trường | |
---|---|
question |
Bắt buộc. Câu hỏi được hiển thị. |
image |
Hình ảnh hiển thị trong câu hỏi. |
Câu hỏi
Mọi câu hỏi. Loại câu hỏi cụ thể được xác định bằng kind
.
Biểu diễn dưới dạng JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Trường | |
---|---|
questionId |
Chỉ có thể đọc. Mã câu hỏi. Bạn có thể cung cấp mã này khi tạo, nhưng mã này không được trùng với mã đã dùng trong biểu mẫu. Nếu bạn không cung cấp, hệ thống sẽ chỉ định một mã nhận dạng mới. |
required |
Người trả lời có phải trả lời câu hỏi thì mới gửi được câu trả lời hay không. |
grading |
Cách thiết lập cách chấm điểm cho câu hỏi. |
Trường hợp hợp nhất kind . Bắt buộc. Loại câu hỏi được đưa ra cho người trả lời. kind chỉ có thể là một trong những loại sau: |
|
choiceQuestion |
Người trả lời có thể chọn trong một nhóm các lựa chọn được xác định trước. |
textQuestion |
Người trả lời có thể nhập câu trả lời dạng văn bản tự do. |
scaleQuestion |
Người trả lời có thể chọn một số trong một dải. |
dateQuestion |
Người trả lời có thể nhập ngày. |
timeQuestion |
Người trả lời có thể nhập thời gian. |
fileUploadQuestion |
Một người trả lời có thể tải một hoặc nhiều tệp lên. |
rowQuestion |
Một hàng của |
ratingQuestion |
Người trả lời có thể chọn một mức phân loại trong một nhóm biểu tượng được xác định trước. |
ChoiceQuestion
Câu hỏi dạng nút chọn/hộp đánh dấu/trình đơn thả xuống.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Bắt buộc. Loại câu hỏi có lựa chọn. |
options[] |
Bắt buộc. Danh sách các lựa chọn mà người trả lời phải chọn. |
shuffle |
Liệu các lựa chọn có được hiển thị theo thứ tự ngẫu nhiên cho các phiên bản khác nhau của bài kiểm tra hay không. Phương pháp này thường được dùng để ngăn chặn hành vi gian lận của những người trả lời có thể nhìn vào màn hình của người trả lời khác hoặc để giải quyết sự thiên vị trong bản khảo sát có thể xảy ra do luôn đặt cùng một lựa chọn ở đầu hoặc cuối. |
ChoiceType
Loại lựa chọn.
Enum | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
RADIO |
Nút chọn: Tất cả các lựa chọn đều hiển thị cho người dùng và họ chỉ có thể chọn một trong số đó. |
CHECKBOX |
Hộp đánh dấu: Tất cả lựa chọn đều hiển thị cho người dùng và họ có thể chọn bất kỳ lựa chọn nào. |
DROP_DOWN |
Trình đơn thả xuống: Các lựa chọn chỉ hiển thị cho người dùng theo yêu cầu, nếu không thì chỉ lựa chọn hiện tại mới hiển thị. Bạn chỉ có thể chọn một lựa chọn. |
Phương thức
Một lựa chọn cho câu hỏi Lựa chọn.
Biểu diễn dưới dạng JSON |
---|
{ "value": string, "image": { object ( |
Trường | |
---|---|
value |
Bắt buộc. Lựa chọn được trình bày cho người dùng. |
image |
Hiển thị hình ảnh dưới dạng một tuỳ chọn. |
isOther |
Lựa chọn có phải là "khác" hay không. Hiện chỉ áp dụng cho các loại lựa chọn |
Trường hợp hợp nhất go_to_section . Mục sẽ chuyển đến nếu bạn chọn tuỳ chọn này. Hiện chỉ áp dụng cho loại lựa chọn RADIO và SELECT , nhưng không được phép trong QuestionGroupItem . go_to_section chỉ có thể là một trong những loại sau: |
|
goToAction |
Loại điều hướng theo phần. |
goToSectionId |
Mã mặt hàng của tiêu đề mục cần chuyển đến. |
GoToAction
Hằng số để điều hướng theo phần.
Enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
NEXT_SECTION |
Chuyển đến phần tiếp theo. |
RESTART_FORM |
Quay lại đầu biểu mẫu. |
SUBMIT_FORM |
Gửi biểu mẫu ngay lập tức. |
Hình ảnh
Dữ liệu đại diện cho hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Trường | |
---|---|
contentUri |
Chỉ có đầu ra. URI mà bạn có thể tải hình ảnh xuống; URI này chỉ có hiệu lực trong một khoảng thời gian nhất định. |
altText |
Nội dung mô tả hình ảnh xuất hiện khi di chuột lên và được trình đọc màn hình đọc. |
properties |
Thuộc tính của hình ảnh. |
Trường hợp hợp nhất image_source . Loại nguồn hình ảnh. Bạn phải đặt đúng một trường nguồn hình ảnh khi tạo hình ảnh mới. image_source chỉ có thể là một trong những loại sau: |
|
sourceUri |
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. |
MediaProperties
Thuộc tính của nội dung nghe nhìn.
Biểu diễn dưới dạng JSON |
---|
{
"alignment": enum ( |
Trường | |
---|---|
alignment |
Vị trí của nội dung nghe nhìn. |
width |
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 giá trị nhỏ hơn giữa giá trị này hoặc chiều rộng của biểu mẫu hiển thị. Tỷ lệ khung hình gốc của nội dung nghe nhì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 xác định khi cập nhật nguồn nội dung nghe nhìn. |
Căn chỉnh
Căn chỉnh trên trang.
Enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
LEFT |
Căn trái. |
RIGHT |
Căn phải. |
CENTER |
Giữa. |
TextQuestion
Câu hỏi dạng văn bản.
Biểu diễn dưới dạng JSON |
---|
{ "paragraph": boolean } |
Trường | |
---|---|
paragraph |
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à câu hỏi dạng văn bản ngắn. |
ScaleQuestion
Câu hỏi theo thang điểm. Người dùng có một phạm vi các giá trị số để lựa chọn.
Biểu diễn dưới dạng JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Trường | |
---|---|
low |
Bắt buộc. Giá trị thấp nhất có thể có của thang điểm. |
high |
Bắt buộc. Giá trị cao nhất có thể cho thang điểm. |
lowLabel |
Nhãn hiển thị mô tả điểm thấp nhất trên thang điểm. |
highLabel |
Nhãn hiển thị mô tả điểm cao nhất trên thang điểm. |
DateQuestion
Câu hỏi về ngày. Theo mặc định, câu hỏi về ngày chỉ có tháng + ngày.
Biểu diễn dưới dạng JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Trường | |
---|---|
includeTime |
Liệu có nên đưa thời gian vào câu hỏi hay không. |
includeYear |
Liệu có nên thêm năm vào câu hỏi hay không. |
TimeQuestion
Câu hỏi về thời gian.
Biểu diễn dưới dạng JSON |
---|
{ "duration": boolean } |
Trường | |
---|---|
duration |
|
FileUploadQuestion
Câu hỏi yêu cầu tải tệp lên. API hiện không hỗ trợ việc tạo câu hỏi tải tệp lên.
Biểu diễn dưới dạng JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Trường | |
---|---|
folderId |
Bắt buộc. Mã của thư mục Drive nơi lưu trữ các tệp đã tải lên. |
types[] |
Các loại tệp được chấp nhận cho câu hỏi này. |
maxFiles |
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. |
maxFileSize |
Số byte tối đa được phép cho mỗi tệp tải lên câu hỏi này. |
FileType
Các loại tệp có thể tải lên câu hỏi tải tệp lên.
Enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
ANY |
Không có hạn chế về loại. |
DOCUMENT |
Tài liệu trên Google Tài liệu. |
PRESENTATION |
Một bản trình bày trên Google Trang trình bày. |
SPREADSHEET |
Một bảng tính trên Google Trang tính. |
DRAWING |
Một bản vẽ. |
PDF |
Tệp PDF. |
IMAGE |
Hình ảnh. |
VIDEO |
Một video. |
AUDIO |
Tệp âm thanh. |
RowQuestion
Cấu hình cho một câu hỏi thuộc một nhóm câu hỏi.
Biểu diễn dưới dạng JSON |
---|
{ "title": string } |
Trường | |
---|---|
title |
Bắt buộc. Tiêu đề cho một hàng trong |
RatingQuestion
Câu hỏi về điểm xếp hạng. Người dùng có một loạt biểu tượng để lựa chọn.
Biểu diễn dưới dạng JSON |
---|
{
"ratingScaleLevel": integer,
"iconType": enum ( |
Trường | |
---|---|
ratingScaleLevel |
Bắt buộc. Cấp thang điểm xếp hạng của câu hỏi xếp hạng. |
iconType |
Bắt buộc. Loại biểu tượng để sử dụng cho điểm xếp hạng. |
RatingIconType
Loại biểu tượng sẽ sử dụng cho điểm xếp hạng.
Enum | |
---|---|
RATING_ICON_TYPE_UNSPECIFIED |
Giá trị mặc định. Không sử dụng. |
STAR |
Biểu tượng dấu sao. |
HEART |
Biểu tượng trái tim. |
THUMB_UP |
Biểu tượng ngón tay cái quay xuống. |
Chấm điểm
Chấm điểm một câu hỏi
Biểu diễn dưới dạng JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Trường | |
---|---|
pointValue |
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 âm. |
correctAnswers |
Bắt buộc. Đáp án cho câu hỏi. Câu trả lời sẽ được tự động chấm điểm dựa trên trường này. |
whenRight |
Nội dung phản hồi hiển thị cho câu trả lời đúng. Bạn chỉ có thể đặt phản hồi này cho các câu hỏi trắc nghiệm có câu trả lời đúng. |
whenWrong |
Nội dung phản hồi xuất hiện cho các câu trả lời không chính xác. Bạn chỉ có thể đặt phản hồi này cho các câu hỏi trắc nghiệm có câu trả lời đúng. |
generalFeedback |
Phản hồi xuất hiện cho tất cả câu trả lời. Tính năng này thường được 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ọ có trả lời đúng câu hỏi hay không trước khi có cơ hội chấm điểm chính thức cho câu trả lời. Bạn 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. |
CorrectAnswers
Đáp án cho một câu hỏi.
Biểu diễn dưới dạng JSON |
---|
{
"answers": [
{
object ( |
Trường | |
---|---|
answers[] |
Danh sách câu trả lời đúng. Hệ thống có thể tự động chấm điểm câu trả lời của bài kiểm tra dựa trên những câu trả lời này. Đối với câu hỏi có giá trị đơn, câu trả lời được đánh dấu là đúng 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 câu hỏi có nhiều giá trị ( |
CorrectAnswer
Một câu trả lời đúng cho một câu hỏi. Đối với câu hỏi có nhiều giá trị (CHECKBOX
), có thể cần một số CorrectAnswer
để biểu thị một phương án trả lời đúng.
Biểu diễn dưới dạng JSON |
---|
{ "value": string } |
Trường | |
---|---|
value |
Bắt buộc. Giá trị của câu trả lời đúng. Hãy xem tài liệu về |
QuestionGroupItem
Xác định một câu hỏi bao gồm nhiều câu hỏi được nhóm lại với nhau.
Biểu diễn dưới dạng JSON |
---|
{ "questions": [ { object ( |
Trường | |
---|---|
questions[] |
Bắt buộc. Danh sách câu hỏi thuộc nhóm câu hỏi này. Một câu hỏi chỉ được thuộc về một nhóm. |
image |
Hình ảnh hiển thị trong nhóm câu hỏi phía trên các câu hỏi cụ thể. |
Trường hợp hợp nhất kind . Bắt buộc. Loại nhóm câu hỏi xác định những loại câu hỏi được phép và cách hiển thị các câu hỏi đó. kind chỉ có thể là một trong những loại sau: |
|
grid |
Nhóm câu hỏi là một lưới có các hàng câu hỏi trắc nghiệm có cùng các phương án. Khi bạn đặt |
Lưới
Lưới gồm các lựa chọn (nút chọn hoặc hộp đánh dấu) với mỗi hàng là một câu hỏi riêng biệt. Mỗi hàng có cùng các lựa chọn, được hiển thị dưới dạng cột.
Biểu diễn dưới dạng JSON |
---|
{
"columns": {
object ( |
Trường | |
---|---|
columns |
Bắt buộc. Các lựa chọn mà mỗi câu hỏi trong lưới chia sẻ. Nói cách khác, đó là giá trị của các cột. Chỉ cho phép lựa chọn |
shuffleQuestions |
Nếu là |
PageBreakItem
Loại này không có trường nào.
Dấu ngắt trang. Tiêu đề và nội dung mô tả của mục này sẽ xuất hiện ở đầu trang mới.
TextItem
Loại này không có trường nào.
Một mục văn bản.
ImageItem
Một mục chứa hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{
"image": {
object ( |
Trường | |
---|---|
image |
Bắt buộc. Hình ảnh hiển thị trong mục. |
VideoItem
Một mục chứa video.
Biểu diễn dưới dạng JSON |
---|
{
"video": {
object ( |
Trường | |
---|---|
video |
Bắt buộc. Video xuất hiện trong mặt hàng. |
caption |
Văn bản xuất hiện bên dưới video. |
Video
Dữ liệu đại diện cho một video.
Biểu diễn dưới dạng JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Trường | |
---|---|
youtubeUri |
Bắt buộc. URI YouTube. |
properties |
Thuộc tính của video. |
PublishSettings
Chế độ cài đặt xuất bản của một biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{
"publishState": {
object ( |
Trường | |
---|---|
publishState |
Không bắt buộc. Trạng thái xuất bản của biểu mẫu. Khi cập nhật |
PublishState
Trạng thái xuất bản của biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "isPublished": boolean, "isAcceptingResponses": boolean } |
Trường | |
---|---|
isPublished |
Bắt buộc. Liệu biểu mẫu đã được xuất bản và người khác có nhìn thấy biểu mẫu đó hay không. |
isAcceptingResponses |
Bắt buộc. Liệu biểu mẫu có chấp nhận câu trả lời hay không. Nếu |
Phương thức |
|
---|---|
|
Thay đổi biểu mẫu bằng một loạt nội dung cập nhật. |
|
Tạo một biểu mẫu mới bằng cách sử dụng tiêu đề được cung cấp trong thông báo biểu mẫu trong yêu cầu. |
|
Nhận biểu mẫu. |
|
Cập nhật chế độ cài đặt xuất bản của một biểu mẫu. |