Class FormApp

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

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

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

Thuộc tính

Thuộc tính	Loại	Mô tả
`Alignment`	`Alignment`	Một danh sách liệt kê các loại căn chỉnh hình ảnh.
`DestinationType`	`DestinationType`	Một danh sách 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.
`FeedbackType`	`FeedbackType`	Một danh sách liệt kê các loại `Feedbacks` biểu mẫu.
`ItemType`	`ItemType`	Một danh sách liệt kê các loại `Items` biểu mẫu.
`PageNavigationType`	`PageNavigationType`	Một bảng liệt kê các hành vi có thể xảy ra khi điều hướng các trang.
`RatingIconType`	`RatingIconType`	Một danh sách liệt kê các loại biểu tượng xếp hạng `RatingIcons`

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`create(title)`	`Form`	Tạo và trả về một `Form` mới.
`create(title, isPublished)`	`Form`	Tạo và trả về một `Form` mới ở trạng thái xuất bản được yêu cầu.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	Trả về một thực thể của CheckboxGridValidationBuilder. Thực thể này có thể dùng để đặt quy trình xác thực trên một `CheckboxGridItem`.
`createCheckboxValidation()`	`CheckboxValidationBuilder`	Trả về một thực thể của CheckboxValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một `CheckboxItem`.
`createFeedback()`	`QuizFeedbackBuilder`	Trả về một thực thể của QuizFeedbackBuilder có thể dùng để đặt ý kiến phản hồi về một `Item` có thể chấm điểm.
`createGridValidation()`	`GridValidationBuilder`	Trả về một thực thể của GridValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một `GridItem`.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	Trả về một thực thể của ParagraphTextValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một `ParagraphTextItem`.
`createTextValidation()`	`TextValidationBuilder`	Trả về một thực thể của TextValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một `TextItem`.
`getActiveForm()`	`Form`	Trả về biểu mẫu mà tập lệnh được liên kết với vùng chứa.
`getUi()`	`Ui`	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.
`openById(id)`	`Form`	Trả về `Form` có mã nhận dạng được chỉ định.
`openByUrl(url)`	`Form`	Trả về `Form` có URL được chỉ định.

Tài liệu chi tiết

`create(title)`

Tạo và trả về một Form mới. Đưa ra một ngoại lệ nếu tiêu đề đã cho là null hoặc trống.

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

Tham số

Tên	Loại	Mô tả
`title`	`String`	Tê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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`create(title, isPublished)`

Tạo và trả về một Form mới ở trạng thái xuất bản được yêu cầu. Đưa ra một trường hợp ngoại lệ nếu tiêu đề đã cho là null hoặc trống.

// Create, publish and open a form.
const form = FormApp.create('Form Name', true);

Tham số

Tên	Loại	Mô tả
`title`	`String`	Tên của biểu mẫu mới.
`isPublished`	`Boolean`	Biểu mẫu có nên được xuất bản hay không.

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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`createCheckboxGridValidation()`

Trả về một thực thể của CheckboxGridValidationBuilder. Thực thể này có thể dùng để đặt quy trình xác thực trên một CheckboxGridItem.

Cầu thủ trả bóng

CheckboxGridValidationBuilder

`createCheckboxValidation()`

Trả về một thực thể của CheckboxValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một CheckboxItem.

Cầu thủ trả bóng

CheckboxValidationBuilder

`createFeedback()`

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

Cầu thủ trả bóng

QuizFeedbackBuilder

`createGridValidation()`

Trả về một thực thể của GridValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một GridItem.

Cầu thủ trả bóng

GridValidationBuilder

`createParagraphTextValidation()`

Trả về một thực thể của ParagraphTextValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một ParagraphTextItem.

Cầu thủ trả bóng

ParagraphTextValidationBuilder

`createTextValidation()`

Trả về một thực thể của TextValidationBuilder. Bạn có thể dùng thực thể này để đặt quy trình xác thực trên một TextItem.

Cầu thủ trả bóng

TextValidationBuilder

`getActiveForm()`

Trả về biểu mẫu mà tập lệnh được liên kết với 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 với vùng chứa, hãy sử dụng openById(id) hoặc openByUrl(url).

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

Cầu thủ trả bóng

Form – biểu mẫu mà tập lệnh được liên kết hoặc null nếu tập lệnh không được liên kết với biểu mẫu

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 một trình chỉnh sửa biểu mẫu đang mở (không phải chế độ xem mà người trả lời nhìn thấy) và chỉ khi tập lệnh được liên kết với biểu mẫu. Để biết thêm thông tin, hãy xem hướng dẫn về trình đơn và hộp thoại cũng như 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 phiên bản của môi trường giao diện người dùng trong biểu mẫu này

`openById(id)`

Trả về Form có mã nhận dạng được chỉ định. Gây ra 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

Tham số

Tên	Loại	Mô tả
`id`	`String`	mã 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 đã cho không hợp lệ hoặc người dùng không có đủ quyền

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

`openByUrl(url)`

Trả về Form có URL được chỉ định. Gây ra 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.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL của biểu mẫu cần mở

Cầu thủ trả bóng

Form – biểu mẫu có URL đã cho

Gửi

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Class FormApp Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Thuộc tính

Phương thức

Tài liệu chi tiết

create(title)

Tham số

Cầu thủ trả bóng

Gửi

Ủy quyền

create(title, isPublished)

Tham số

Cầu thủ trả bóng

Gửi

Ủy quyền

createCheckboxGridValidation()

Cầu thủ trả bóng

createCheckboxValidation()

Cầu thủ trả bóng

createFeedback()

Cầu thủ trả bóng

createGridValidation()

Cầu thủ trả bóng

createParagraphTextValidation()

Cầu thủ trả bóng

createTextValidation()

Cầu thủ trả bóng

getActiveForm()

Cầu thủ trả bóng

Ủy quyền

getUi()

Cầu thủ trả bóng

openById(id)

Tham số

Cầu thủ trả bóng

Gửi

Ủy quyền

openByUrl(url)

Tham số

Cầu thủ trả bóng

Gửi

Ủy quyền

Class FormApp

`create(title)`

`create(title, isPublished)`

`createCheckboxGridValidation()`

`createCheckboxValidation()`

`createFeedback()`

`createGridValidation()`

`createParagraphTextValidation()`

`createTextValidation()`

`getActiveForm()`

`getUi()`

`openById(id)`

`openByUrl(url)`