Cho phép tập lệnh mở 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
Tài sản | Loại | Nội dung mô tả |
---|---|---|
Alignment | Alignment | Bảng liệt kê các loại căn chỉnh hình ảnh. |
DestinationType | DestinationType | Bảng liệt kê các loại đích đến có thể lưu trữ câu trả lời trong biểu mẫu. |
FeedbackType | FeedbackType | Bảng liệt kê các loại biểu mẫu Feedbacks . |
ItemType | ItemType | Bảng liệt kê các loại biểu mẫu Items . |
PageNavigationType | PageNavigationType | Bảng liệt kê các hành vi có thể xảy ra khi di chuyển trên trang. |
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. |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | Trả về một thực thể của CheckboxGridValidationBuilder có thể dùng để thiết lập tính năng xác thực trên CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | Trả về một thực thể của CheckboxValidationBuilder có thể dùng để thiết lập tính năng xác thực trên CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | Trả về một thực thể của QuizFeedbackBuilder. Bạn có thể dùng một thực thể này để đặ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 có thể dùng để thiết lập tính năng xác thực trên GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | Trả về một thực thể của ParagraphTextValidationBuilder mà có thể dùng để thiết lập tính năng xác thực trên
ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | 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 . |
getActiveForm() | Form | Trả về biểu mẫu có tập lệnh liên kết vùng chứa. |
getUi() | Ui | Trả về một thực thể 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 đã chỉ định. |
openByUrl(url) | Form | Trả về Form có 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 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');
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ 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ể dùng để thiết lập tính năng xác thực trên CheckboxGridItem
.
Cầu thủ trả bóng
createCheckboxValidation()
Trả về một thực thể của CheckboxValidationBuilder có thể dùng để thiết lập tính năng xác thực trên CheckboxItem
.
Cầu thủ trả bóng
createFeedback()
Trả về một thực thể của QuizFeedbackBuilder. Bạn có thể dùng một thực thể này để đặt ý kiến phản hồi về một Item
có thể chấm điểm.
Cầu thủ trả bóng
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
createParagraphTextValidation()
Trả về một thực thể của ParagraphTextValidationBuilder mà 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
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
getActiveForm()
Trả về biểu mẫu có tập lệnh liên kết 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)
.
// Get the form to which this script is bound. var 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 một biểu mẫu
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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 thực thể 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 thực thể hiện tại của trình chỉnh sửa biểu mẫu đang mở (không phải khung hiển thị 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 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 phiên bản 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
có mã nhận dạng đã chỉ định. Gửi một trường hợp 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');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
id | String | mã 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ó đủ quyền
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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
có 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' );
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms