列と行のグリッドとして表示される質問アイテム。回答者は、一連のチェックボックスから行ごとに複数の選択肢を選択できます。アイテムは Form
からアクセスまたは作成できます。
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
clearValidation() | CheckboxGridItem | このグリッド アイテムに対するデータの入力規則を削除します。 |
createResponse(responses) | ItemResponse | このチェックボックスのグリッド アイテム用に新しい ItemResponse を作成します。 |
duplicate() | CheckboxGridItem | このアイテムのコピーを作成して、フォームの末尾に追加します。 |
getColumns() | String[] | グリッド内のすべての列の値を取得します。 |
getHelpText() | String | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキスト)を取得します。 |
getId() | Integer | アイテムの一意の識別子を取得します。 |
getIndex() | Integer | フォーム内のすべてのアイテムの中でアイテムのインデックスを取得します。 |
getRows() | String[] | グリッド内のすべての行の値を取得します。 |
getTitle() | String | アイテムのタイトル(SectionHeaderItem の場合にヘッダー テキストとも呼ばれます)を取得します。 |
getType() | ItemType | ItemType で表されるアイテムのタイプを取得します。 |
isRequired() | Boolean | 回答者が質問に回答する必要があるかどうかを判断します。 |
setColumns(columns) | CheckboxGridItem | 値の配列に基づいてグリッドの列を設定します。 |
setHelpText(text) | CheckboxGridItem | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキスト)を設定します。 |
setRequired(enabled) | CheckboxGridItem | 回答者が質問に回答する必要があるかどうかを設定します。 |
setRows(rows) | CheckboxGridItem | 値の配列に基づいてグリッドの行を設定します。 |
setTitle(title) | CheckboxGridItem | アイテムのタイトル(SectionHeaderItem ではヘッダー テキストとも呼ばれます)を設定します。 |
setValidation(validation) | CheckboxGridItem | このチェックボックスのグリッド アイテムのデータ検証を設定します。 |
詳細なドキュメント
clearValidation()
このグリッド アイテムに対するデータの入力規則を削除します。
リターン
CheckboxGridItem
- このアイテム(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
このチェックボックスのグリッド アイテム用に新しい ItemResponse
を作成します。引数 responses
は、チェックボックス グリッド内の入力数と同じ数の値を含む配列の String[][]
配列である必要があります。必須ではないチェックボックス グリッドの質問の null
要素は、その行に対する回答がないことを示します。いずれかの値が有効な選択と一致しない場合に、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
responses | String[][] | このチェックボックスのグリッド アイテムに対する有効な回答の配列の配列 |
リターン
ItemResponse
- アイテムのレスポンス
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
このアイテムのコピーを作成して、フォームの末尾に追加します。
リターン
CheckboxGridItem
- この CheckboxGridItem
の重複(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
グリッド内のすべての列の値を取得します。
リターン
String[]
- 列の値の配列。フォームの表示時に回答者にラベルとして表示されます。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキスト)を取得します。
リターン
String
- アイテムのヘルプテキストまたは説明テキスト
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
アイテムの一意の識別子を取得します。
リターン
Integer
- 商品アイテムの ID
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
フォーム内のすべてのアイテムの中でアイテムのインデックスを取得します。
リターン
Integer
- アイテムのインデックス
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
グリッド内のすべての行の値を取得します。
リターン
String[]
- 行の値の配列。フォームの表示時に回答者にラベルとして表示されます。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
アイテムのタイトル(SectionHeaderItem
の場合にヘッダー テキストとも呼ばれます)を取得します。
リターン
String
- アイテムのタイトルまたはヘッダー テキスト
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
回答者が質問に回答する必要があるかどうかを判断します。
リターン
Boolean
- 回答者が質問に回答する必要があるかどうか
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
値の配列に基づいてグリッドの列を設定します。指定された配列が空の場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
columns | String[] | 列の値の配列(フォームの表示時に回答者がラベルとして表示されます) |
リターン
CheckboxGridItem
- このアイテム(チェーン用)
例外
Error
- 指定された配列が null
または空の場合
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
リターン
CheckboxGridItem
- この CheckboxGridItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
回答者が質問に回答する必要があるかどうかを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enabled | Boolean | 回答者が質問に答える必要があるかどうか |
リターン
CheckboxGridItem
- 現在のアイテム(チェーンの場合)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
値の配列に基づいてグリッドの行を設定します。指定された配列が空の場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
rows | String[] | 行の値の配列(フォームの閲覧時に回答者がラベルとして表示されます) |
リターン
CheckboxGridItem
- このアイテム(チェーン用)
例外
Error
- 指定された配列が null
または空の場合
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
アイテムのタイトル(SectionHeaderItem
ではヘッダー テキストとも呼ばれます)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
リターン
CheckboxGridItem
- この CheckboxGridItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
このチェックボックスのグリッド アイテムのデータ検証を設定します。null や、require 関数を呼び出さずに検証を渡すと、以前の検証がすべて削除されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
validation | CheckboxGridValidation | このアイテムに適用する CheckboxGridValidation。 |
リターン
CheckboxGridItem
- この CheckboxGridItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms