Class FormApp

FormApp

Cho phép tập lệnh mở một Form hiện có hoặc tạo một tập lệnh mới.

// Open a form by ID.
var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
var newForm = FormApp.create('Form Name');

Thuộc tính

Thuộc tínhLoạiMô tả
AlignmentAlignmentBảng liệt kê các kiểu căn chỉnh hình ảnh.
DestinationTypeDestinationTypeBảng liệt kê các loại đích đến có thể lưu trữ câu trả lời của biểu mẫu.
FeedbackTypeFeedbackTypeBảng liệt kê các loại biểu mẫu Feedbacks.
ItemTypeItemTypeBảng liệt kê các loại biểu mẫu Items.
PageNavigationTypePageNavigationTypeBảng liệt kê các hành vi có thể xảy ra khi điều hướng trên trang.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
create(title)FormTạo và trả về một Form mới.
createCheckboxGridValidation()CheckboxGridValidationBuilderTrả về một thực thể của CheckboxGridValidationBuilder có thể dùng để thiết lập quy tắc xác thực trên CheckboxGridItem.
createCheckboxValidation()CheckboxValidationBuilderTrả về một thực thể của CheckboxValidationBuilder có thể được dùng để thiết lập quy tắc xác thực trên CheckboxItem.
createFeedback()QuizFeedbackBuilderTrả về một thực thể của AI FeedbackBuilder có thể dùng để đặt ý kiến phản hồi về bài tập có thể chấm điểm Item.
createGridValidation()GridValidationBuilderTrả về một thực thể của GridValidationBuilder có thể dùng để thiết lập tính năng xác thực trên GridItem.
createParagraphTextValidation()ParagraphTextValidationBuilderTrả về một bản sao của ĐoạnTextValidationBuilder có thể dùng để thiết lập tính năng xác thực trên ParagraphTextItem.
createTextValidation()TextValidationBuilderTrả về một thực thể của TextValidationBuilder có thể dùng để thiết lập tính năng xác thực trên TextItem.
getActiveForm()FormTrả về biểu mẫu cho tập lệnh ghép vùng chứa.
getUi()UiTrả về một phiên bản của môi trường giao diện người dùng của trình chỉnh sửa biểu mẫu cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên.
openById(id)FormTrả về Form với mã nhận dạng đã chỉ định.
openByUrl(url)FormTrả về Form kèm theo URL đã chỉ định.

Tài liệu chi tiết

create(title)

Tạo và trả về một Form mới. Gửi một trường hợp ngoại lệ nếu tiêu đề đã cho là null hoặc trống.

// Create and open a form.
var form = FormApp.create('Form Name');

Tham số

TênLoạiMô tả
titleStringtên của biểu mẫu mới

Cầu thủ trả bóng

Form – biểu mẫu mới

Gửi

Error – nếu tiêu đề đã cho là null hoặc trống

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/forms

createCheckboxGridValidation()

Trả về một thực thể của CheckboxGridValidationBuilder có thể được dùng để thiết lập quy tắc xác thực trên CheckboxGridItem.

Cầu thủ trả bóng

CheckboxGridValidationBuilder


createCheckboxValidation()

Trả về một thực thể của CheckboxValidationBuilder có thể được dùng để thiết lập quy tắc xác thực trên CheckboxItem.

Cầu thủ trả bóng

CheckboxValidationBuilder


createFeedback()

Trả về một thực thể của AI FeedbackBuilder có thể dùng để đặt ý kiến phản hồi về bài tập có thể chấm điểm Item.

Cầu thủ trả bóng

QuizFeedbackBuilder


createGridValidation()

Trả về một thực thể của GridValidationBuilder có thể dùng để thiết lập tính năng xác thực trên GridItem.

Cầu thủ trả bóng

GridValidationBuilder


createParagraphTextValidation()

Trả về một bản sao của ĐoạnTextValidationBuilder có thể dùng để thiết lập tính năng xác thực trên ParagraphTextItem.

Cầu thủ trả bóng

ParagraphTextValidationBuilder


createTextValidation()

Trả về một thực thể của TextValidationBuilder có thể dùng để thiết lập tính năng xác thực trên TextItem.

Cầu thủ trả bóng

TextValidationBuilder


getActiveForm()

Trả về biểu mẫu cho tập lệnh ghép vùng chứa. Để tương tác với các biểu mẫu mà tập lệnh không bị ràng buộc bởi vùng chứa, hãy sử dụng openById(id) hoặc openByUrl(url) thay thế.

// Get the form to which this script is bound.
var form = FormApp.getActiveForm();

Cầu thủ trả bóng

Form – dạng thức mà tập lệnh bị liên kết hoặc null nếu tập lệnh không liên kết với một biểu mẫu

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getUi()

Trả về một phiên bản của môi trường giao diện người dùng của trình chỉnh sửa biểu mẫu cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên. Một tập lệnh chỉ có thể tương tác với giao diện người dùng cho phiên bản hiện tại của trình chỉnh sửa biểu mẫu mở (không phải chế độ xem mà người trả lời nhìn thấy) và chỉ khi tập lệnh bị giới hạn với biểu mẫu. Để biết thêm hãy xem hướng dẫn về trình đơn cũng như hộp thoại và thanh bên.

// Add a custom menu to the active form, including a separator and a sub-menu.
function onOpen(e) {
  FormApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(FormApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Cầu thủ trả bóng

Ui – một thực thể của môi trường giao diện người dùng của biểu mẫu này


openById(id)

Trả về Form với mã nhận dạng đã chỉ định. Gửi một ngoại lệ nếu mã nhận dạng không hợp lệ hoặc người dùng không có quyền mở biểu mẫu.

// Open a form by ID.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Tham số

TênLoạiMô tả
idStringmã nhận dạng của biểu mẫu cần mở

Cầu thủ trả bóng

Form – biểu mẫu có mã nhận dạng đã cho

Gửi

Error – nếu mã nhận dạng đã cung cấp không hợp lệ hoặc người dùng không có đủ thông tin quyền

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/forms

openByUrl(url)

Trả về Form kèm theo URL đã chỉ định. Gửi một ngoại lệ nếu URL không hợp lệ hoặc người dùng không có quyền mở biểu mẫu.

// Open a form by URL.
var form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit'
    );

Tham số

TênLoạiMô tả
urlStringURL của biểu mẫu cần mở

Cầu thủ trả bóng

Form – biểu mẫu với URL đã cho

Gửi

Error – nếu URL đã cho không hợp lệ hoặc người dùng không có đủ thông tin quyền

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/forms