質問項目(列と行のグリッドとして表示される)で、回答者は一連のラジオボタンから行ごとに 1 つの選択肢を選択できます。アイテムへのアクセスや作成には 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']);
Methods
方法 | 戻り値の型 | 概要 |
---|---|---|
clearValidation() | GridItem | このグリッド アイテムのデータ検証を削除します。 |
createResponse(responses) | ItemResponse | このグリッド アイテム用に新しい ItemResponse を作成します。 |
duplicate() | GridItem | このアイテムのコピーを作成し、フォームの末尾に追加します。 |
getColumns() | String[] | グリッド内のすべての列の値を取得します。 |
getHelpText() | String | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を取得します。 |
getId() | Integer | アイテムの一意の識別子を取得します。 |
getIndex() | Integer | フォーム内のすべてのアイテムの中から、そのアイテムのインデックスを取得します。 |
getRows() | String[] | グリッド内のすべての行の値を取得します。 |
getTitle() | String | アイテムのタイトルを取得します(SectionHeaderItem の場合はヘッダー テキストと呼ばれることもあります)。 |
getType() | ItemType | ItemType として表されるアイテムのタイプを取得します。 |
isRequired() | Boolean | 回答者が質問に答えなければならないかどうかを決定します。 |
setColumns(columns) | GridItem | 値の配列に基づいてグリッドの列を設定します。 |
setHelpText(text) | GridItem | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。 |
setRequired(enabled) | GridItem | 回答者が質問に答える必要があるかどうかを設定します。 |
setRows(rows) | GridItem | 値の配列に基づいてグリッドの行を設定します。 |
setTitle(title) | GridItem | アイテムのタイトルを設定します(SectionHeaderItem の場合はヘッダー テキストとも呼ばれます)。 |
setValidation(validation) | GridItem | このグリッド アイテムのデータ検証を設定します。 |
詳細なドキュメント
clearValidation()
createResponse(responses)
このグリッド アイテム用に新しい ItemResponse
を作成します。引数 responses
は、グリッド内の行数と同じ値を含む String[]
配列である必要があります。不要なグリッド形式の質問の null
要素は、その行への応答がないことを示します。いずれかの値が有効な選択と一致しない場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
responses | String[] | このグリッド アイテムに対する有効な回答の配列 |
戻る
ItemResponse
- アイテムのレスポンス
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
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)
setHelpText(text)
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
戻る
GridItem
- この GridItem
(チェーンの場合)
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
setRows(rows)
値の配列に基づいてグリッドの行を設定します。指定された配列が空の場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
rows | String[] | フォームの値を表示したときに、回答者がラベルとして認識する行の値の配列 |
戻る
GridItem
- このアイテムのチェーン
スロー値
Error
- 指定した配列が null
または空の場合
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
アイテムのタイトルを設定します(SectionHeaderItem
の場合はヘッダー テキストとも呼ばれます)。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
戻る
GridItem
- この GridItem
(チェーンの場合)
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
このグリッド アイテムのデータ検証を設定します。null または検証を必須関数なしで渡すと、以前の検証が削除されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
validation | GridValidation | このアイテムに適用する GridValidation です。 |
戻る
GridItem
- この GridItem
(チェーンの場合)
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms