このページは Cloud Translation API によって翻訳されました。

Class GridItem

質問項目。列と行のグリッドとして表示され、回答者はラジオボタンのシーケンスから 1 行につき 1 つの選択肢を選択できます。アイテムには 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']);

メソッド

メソッド	戻り値の型	概要
`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()`

このグリッドアイテムのデータ検証を削除します。

戻る

GridItem - チェーン用のこのアイテム

承認

このメソッドを使用するスクリプトには、次の 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()`

この項目のコピーを作成し、フォームの末尾に追加します。

戻る

GridItem - チェーン用のこの GridItem の複製

承認

このメソッドを使用するスクリプトには、次の 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()`

ItemType として表されるアイテムのタイプを取得します。

戻る

ItemType - アイテムのタイプ

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isRequired()`

回答者が質問に回答する必要があるかどうかを決定します。

戻る

Boolean - 回答者が質問に回答する必要があるかどうか

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setColumns(columns)`

値の配列に基づいてグリッドの列を設定します。指定された配列が空の場合、例外をスローします。

パラメータ

名前	型	説明
`columns`	`String[]`	列の値の配列。回答者がフォームを表示するときにラベルとして表示される

戻る

GridItem - チェーン用のこのアイテム

例外

Error - 指定された配列が null または空の場合

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`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)`

回答者が質問に回答する必要があるかどうかを設定します。

パラメータ

名前	型	説明
`enabled`	`Boolean`	回答者が質問に回答する必要があるかどうか

戻る

GridItem - 現在のアイテム（チェーン用）

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`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 または require 関数が呼び出されていない GridValidation インスタンスを渡すと、以前の検証がすべて削除されます。

パラメータ

名前	型	説明
`validation`	`GridValidation`	このアイテムに適用する GridValidation。

戻る

GridItem - チェーン用の GridItem

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

Class GridItem コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

メソッド

詳細なドキュメント

clearValidation()

戻る

承認

createResponse(responses)

パラメータ

戻る

承認

duplicate()

戻る

承認

getColumns()

戻る

承認

getHelpText()

戻る

承認

getId()

戻る

承認

getIndex()

戻る

承認

getRows()

戻る

承認

getTitle()

戻る

承認

getType()

戻る

承認

isRequired()

戻る

承認

setColumns(columns)

パラメータ

戻る

例外

承認

setHelpText(text)

パラメータ

戻る

承認

setRequired(enabled)

パラメータ

戻る

承認

setRows(rows)

パラメータ

戻る

例外

承認

setTitle(title)

パラメータ

戻る

承認

setValidation(validation)

パラメータ

戻る

承認

Class GridItem

`clearValidation()`

`createResponse(responses)`

`duplicate()`

`getColumns()`

`getHelpText()`

`getId()`

`getIndex()`

`getRows()`

`getTitle()`

`getType()`

`isRequired()`

`setColumns(columns)`

`setHelpText(text)`

`setRequired(enabled)`

`setRows(rows)`

`setTitle(title)`

`setValidation(validation)`