Mục câu hỏi được trình bày dưới dạng một lưới gồm các cột và hàng, cho phép người trả lời chọn một câu trả lời 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 qua Form
.
// Open a form by ID and add a new grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
clearValidation() | GridItem | Xoá mọi thông tin xác thực dữ liệu cho mục trong lưới này. |
createResponse(responses) | ItemResponse | Tạo một ItemResponse mới cho mục trong lưới này. |
duplicate() | GridItem | Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu. |
getColumns() | String[] | Lấy giá trị cho mỗi cột trong lưới. |
getHelpText() | String | Lấy văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems , PageBreakItems và SectionHeaderItems ). |
getId() | Integer | Lấy giá trị nhận dạng duy nhất của mặt hàng. |
getIndex() | Integer | Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu. |
getRows() | String[] | Lấy giá trị cho mỗi hàng trong lưới. |
getTitle() | String | Lấy tiêu đề của mục (đôi khi gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem ). |
getType() | ItemType | Lấy loại của mục, được biểu thị dưới dạng ItemType . |
isRequired() | Boolean | Xác định xem người trả lời có phải trả lời câu hỏi hay không. |
setColumns(columns) | GridItem | Đặt các cột của lưới dựa trên mảng giá trị. |
setHelpText(text) | GridItem | Đặt văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems , PageBreakItems và SectionHeaderItems ). |
setRequired(enabled) | GridItem | Thiết lập liệu người trả lời có phải trả lời câu hỏi hay không. |
setRows(rows) | GridItem | Đặt các hàng của lưới dựa trên mảng giá trị. |
setTitle(title) | GridItem | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem ). |
setValidation(validation) | GridItem | Đặt phương thức xác thực dữ liệu cho mục trong lưới này. |
Tài liệu chi tiết
clearValidation()
createResponse(responses)
Tạo một ItemResponse
mới cho mục trong 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ố lượng hàng trong lưới. Phần tử null
của câu hỏi dạng lưới không bắt buộc thể hiện rằng 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ệ.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
responses | String[] | một loạt các câu trả lời hợp lệ cho mục lưới này |
Cầu thủ trả bóng
ItemResponse
– phản hồi mục
Ủ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
duplicate()
Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu.
Cầu thủ trả bóng
GridItem
– bản sao của GridItem
này để tạo chuỗi
Ủ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
getColumns()
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 sẽ thấy dưới dạng nhãn khi xem 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
getHelpText()
Lấy văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems
, PageBreakItems
và SectionHeaderItems
).
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
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
getId()
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ã nhận dạng của mặt hà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.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
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
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
getRows()
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 sẽ thấy dưới dạng nhãn khi xem 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
getTitle()
Lấy tiêu đề của mục (đôi khi gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem
).
Cầu thủ trả bóng
String
— văn bản tiêu đề hoặc tiêu đề của mục
Ủ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
getType()
isRequired()
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
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
setColumns(columns)
Đặt các cột của lưới dựa trên mảng giá trị. Gửi một ngoại lệ nếu mảng đã cho trống.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columns | String[] | một mảng các giá trị cột 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
GridItem
— 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
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
setHelpText(text)
Đặt văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems
, PageBreakItems
và SectionHeaderItems
).
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | văn bản trợ giúp mới |
Cầu thủ trả bóng
GridItem
— GridItem
này, để tạo chuỗi
Ủ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
setRequired(enabled)
Thiết lập liệu người trả lời có phải trả lời câu hỏi hay không.
Các tham số
Tên | Loại | Nội dung 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
GridItem
– mục hiện tại (để tạo chuỗi)
Ủ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
setRows(rows)
Đặt các hàng của lưới dựa trên mảng giá trị. Gửi một ngoại lệ nếu mảng đã cho trống.
Các tham số
Tên | Loại | Nội dung 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
GridItem
— 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
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
setTitle(title)
Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem
).
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề hoặc văn bản tiêu đề mới |
Cầu thủ trả bóng
GridItem
— GridItem
này, để tạo chuỗi
Ủ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
setValidation(validation)
Đặt phương thức xác thực dữ liệu cho mục trong lưới này. Việc chuyển giá trị rỗng hoặc xác thực mà không gọi hàm yêu cầu nào sẽ xoá mọi quy trình xác thực trước đó.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
validation | GridValidation | GridValidation để áp dụng cho mục này. |
Cầu thủ trả bóng
GridItem
— GridItem
này, để tạo chuỗi
Ủ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