Một mục câu hỏi, được trình bày dưới dạng lưới gồm các cột và hàng, cho phép người trả lời chọn một lựa chọn cho mỗi hàng trong một chuỗi các nút chọn. Bạn có thể truy cập hoặc tạo các mục từ Form.
// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
.setRows(['Cars', 'Computers', 'Celebrities'])
.setColumns(['Boring', 'So-so', 'Interesting']);
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
clear | Grid | Xoá mọi quy tắc xác thực dữ liệu cho mục lưới này. |
create | Item | Tạo một Item mới cho mục lưới này. |
duplicate() | Grid | Tạo một bản sao của mục này và thêm vào cuối biểu mẫu. |
get | String[] | Lấy giá trị cho mọi cột trong lưới. |
get | String | Lấy văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như Image, Page và Section). |
get | Integer | Lấy giá trị nhận dạng duy nhất của mặt hàng. |
get | Integer | Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu. |
get | String[] | Lấy giá trị cho mỗi hàng trong lưới. |
get | String | Lấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section). |
get | Item | Lấy loại của mục, được biểu thị dưới dạng Item. |
is | Boolean | Xác định xem người trả lời có phải trả lời câu hỏi hay không. |
set | Grid | Đặt các cột của lưới dựa trên một mảng giá trị. |
set | Grid | Đặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như Image, Page và Section). |
set | Grid | Đặt xem người trả lời có phải trả lời câu hỏi hay không. |
set | Grid | Đặt các hàng của lưới dựa trên một mảng giá trị. |
set | Grid | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section). |
set | Grid | Đặt tính năng xác thực dữ liệu cho mục lưới này. |
Tài liệu chi tiết
clear
create
Tạo một Item mới cho mục lưới này. Đối số responses phải là một mảng String[] chứa số lượng giá trị bằng số hàng trong lưới. Phần tử null cho câu hỏi dạng lưới không bắt buộc cho biết không có câu trả lời nào cho hàng đó. Gửi một ngoại lệ nếu có bất kỳ giá trị nào không khớp với lựa chọn hợp lệ.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
responses | String[] | một mảng các câu trả lời hợp lệ cho mục lưới này |
Cầu thủ trả bóng
Item – phản hồi về mặt hàng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
duplicate()
Tạo một bản sao của mục này và thêm vào cuối biểu mẫu.
Cầu thủ trả bóng
Grid – bản sao của Grid này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy giá trị cho mọi cột trong lưới.
Cầu thủ trả bóng
String[] – một mảng các giá trị cột mà người trả lời nhìn thấy dưới dạng nhãn khi xem biểu mẫu
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như Image, Page và Section).
Cầu thủ trả bóng
String – văn bản trợ giúp hoặc văn bản mô tả của mục
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy giá trị nhận dạng duy nhất của mặt hàng.
Cầu thủ trả bóng
Integer – mã của mặt hàng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
Cầu thủ trả bóng
Integer – chỉ mục của mục
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy giá trị cho mỗi hàng trong lưới.
Cầu thủ trả bóng
String[] – một mảng các giá trị hàng mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
Lấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section).
Cầu thủ trả bóng
String – tiêu đề hoặc văn bản tiêu đề của mục
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
is
Xác định xem người trả lời có phải trả lời câu hỏi hay không.
Cầu thủ trả bóng
Boolean – liệu người trả lời có phải trả lời câu hỏi hay không
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt các cột của lưới dựa trên một mảng giá trị. Gửi một ngoại lệ nếu mảng đã cho trống.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
columns | String[] | một mảng các giá trị cột mà người trả lời nhìn thấy dưới dạng nhãn khi xem biểu mẫu |
Cầu thủ trả bóng
Grid – mục này, để tạo chuỗi
Gửi
Error – nếu mảng đã 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 yêu cầu đượ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
set
Đặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như Image, Page và Section).
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
text | String | văn bản trợ giúp mới |
Cầu thủ trả bóng
Grid – Grid này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt xem người trả lời có phải trả lời câu hỏi hay không.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
enabled | Boolean | liệu người trả lời có phải trả lời câu hỏi hay không |
Cầu thủ trả bóng
Grid – mục hiện tại (để tạo chuỗi)
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt các hàng của lưới dựa trên một mảng giá trị. Gửi một trường hợp ngoại lệ nếu mảng đã cho trống.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
rows | String[] | một mảng các giá trị hàng mà người trả lời sẽ thấy dưới dạng nhãn khi xem biểu mẫu |
Cầu thủ trả bóng
Grid – mục này, để tạo chuỗi
Gửi
Error – nếu mảng đã 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 yêu cầu đượ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
set
Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section).
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
title | String | tiêu đề hoặc văn bản tiêu đề mới |
Cầu thủ trả bóng
Grid – Grid này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt tính năng xác thực dữ liệu cho mục lưới này. Việc truyền giá trị rỗng hoặc giá trị xác thực mà không có hàm yêu cầu nào được gọi sẽ xoá mọi giá trị xác thực trước đó.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
validation | Grid | một GridValidation để áp dụng cho mục này. |
Cầu thủ trả bóng
Grid – Grid này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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