REST Resource: forms

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 (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string,
  "publishSettings": {
    object (PublishSettings)
  }
}
Trường
formId

string

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

info

object (Info)

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

settings

object (FormSettings)

Chế độ cài đặt của biểu mẫu. Bạn phải cập nhật giá trị này bằng UpdateSettingsRequest; giá trị này sẽ bị bỏ qua trong forms.createUpdateFormInfoRequest.

items[]

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, nội dung nghe nhìn được nhúng, v.v.

revisionId

string

Chỉ có đầu ra. Mã bản sửa đổi của biểu mẫu. Được dùng trong WriteControl trong các yêu cầu cập nhật để xác định bản sửa đổi dựa trên 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 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:

  • chế độ cài đặt cách chia sẻ (người có quyền truy cập vào biểu mẫu)
  • publishSettings (nếu biểu mẫu hỗ trợ việc xuất bản và nếu biểu mẫu được xuất bản)
responderUri

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. Đối với các biểu mẫu đã đặt giá trị publishSettings, đây là URI biểu mẫu đã xuất bản.

linkedSheetId

string

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

object (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 publishSettings. Tất cả biểu mẫu mới tạo đều hỗ trợ chế độ cài đặt phát hành.

Các biểu mẫu có giá trị publishSettings được đặt có thể gọi API forms.setPublishSettings để phát hành hoặc huỷ phát hành biểu mẫu.

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

string

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

documentTitle

string

Chỉ có đầu ra. Tiêu đề của tài liệu xuất hiện trong Drive. Nếu Info.title trống, documentTitle có thể xuất hiện thay thế trong giao diện người dùng của Google Biểu mẫu và người trả lời có thể nhìn thấy. Bạn có thể đặt documentTitle khi tạo, nhưng không thể sửa đổi bằng yêu cầu batchUpdate. 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.

description

string

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 (QuizSettings)
  },
  "emailCollectionType": enum (EmailCollectionType)
}
Trường
quizSettings

object (QuizSettings)

Các chế độ cài đặt liên quan đến bài kiểm tra và việc chấm điểm.

emailCollectionType

enum (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

boolean

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 Grading. Khi bạn đặt thành false, tất cả Grading câu hỏi sẽ bị xoá.

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 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.
}
Trường
itemId

string

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

string

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

description

string

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

object (QuestionItem)

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

questionGroupItem

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.

pageBreakItem

object (PageBreakItem)

Bắt đầu một trang mới có tiêu đề.

textItem

object (TextItem)

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

imageItem

object (ImageItem)

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

videoItem

object (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 (Question)
  },
  "image": {
    object (Image)
  }
}
Trường
question

object (Question)

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

image

object (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 (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.
}
Trường
questionId

string

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

boolean

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

object (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

object (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

object (TextQuestion)

Người trả lời có thể nhập câu trả lời dạng văn bản tự do.

scaleQuestion

object (ScaleQuestion)

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

dateQuestion

object (DateQuestion)

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

timeQuestion

object (TimeQuestion)

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

fileUploadQuestion

object (FileUploadQuestion)

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

rowQuestion

object (RowQuestion)

Một hàng của QuestionGroupItem.

ratingQuestion

object (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 (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}
Trường
type

enum (ChoiceType)

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

options[]

object (Option)

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

shuffle

boolean

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 (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.
}
Trường
value

string

Bắt buộc. Lựa chọn được trình bày cho người dùng.

image

object (Image)

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

isOther

boolean

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 RADIOCHECKBOX, nhưng không được phép trong QuestionGroupItem.

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 RADIOSELECT, 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

enum (GoToAction)

Loại điều hướng theo phần.

goToSectionId

string

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 (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.
}
Trường
contentUri

string

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

string

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

object (MediaProperties)

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

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.

MediaProperties

Thuộc tính của nội dung nghe nhìn.

Biểu diễn dưới dạng JSON
{
  "alignment": enum (Alignment),
  "width": integer
}
Trường
alignment

enum (Alignment)

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

width

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

boolean

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

integer

Bắt buộc. Giá trị thấp nhất có thể có của thang điểm.

high

integer

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

lowLabel

string

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

highLabel

string

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

boolean

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

includeYear

boolean

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

boolean

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

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 (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}
Trường
folderId

string

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[]

enum (FileType)

Các loại tệp được chấp nhận cho câu hỏi này.

maxFiles

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.

maxFileSize

string (int64 format)

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

string

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

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 (RatingIconType)
}
Trường
ratingScaleLevel

integer

Bắt buộc. Cấp thang điểm xếp hạng của câu hỏi xếp hạng.

iconType

enum (RatingIconType)

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 (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}
Trường
pointValue

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 âm.

correctAnswers

object (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

object (Feedback)

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

object (Feedback)

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

object (Feedback)

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 (CorrectAnswer)
    }
  ]
}
Trường
answers[]

object (CorrectAnswer)

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ị (CHECKBOX), câu trả lời được đánh dấu là đúng nếu chứa chính xác các giá trị trong danh sách này.

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

string

Bắt buộc. Giá trị của 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ị khác nhau.

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 (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.
}
Trường
questions[]

object (Question)

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. kind của nhóm có thể ảnh hưởng đến loại câu hỏi được phép.

image

object (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

object (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 grid, tất cả câu hỏi trong nhóm phải thuộc loại row.

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 (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}
Trường
columns

object (ChoiceQuestion)

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 CHECK_BOXRADIO.

shuffleQuestions

boolean

Nếu 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 sẽ xuất hiện theo thứ tự khác nhau cho mỗi người trả lời.

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 (Image)
  }
}
Trường
image

object (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 (Video)
  },
  "caption": string
}
Trường
video

object (Video)

Bắt buộc. Video xuất hiện trong mặt hàng.

caption

string

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 (MediaProperties)
  }
}
Trường
youtubeUri

string

Bắt buộc. URI YouTube.

properties

object (MediaProperties)

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 (PublishState)
  }
}
Trường
publishState

object (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, bạn phải đặt cả isPublishedisAcceptingResponses. Tuy nhiên, việc đặt isAcceptingResponses thành trueisPublished thành false không được hỗ trợ và sẽ trả về lỗi.

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

boolean

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

boolean

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 isPublished được đặt thành false, thì trường này sẽ buộc phải là false.

Phương thức

batchUpdate

Thay đổi biểu mẫu bằng một loạt nội dung cập nhật.

create

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.

get

Nhận biểu mẫu.

setPublishSettings

Cập nhật chế độ cài đặt xuất bản của một biểu mẫu.