Class Choice

選択肢

選択肢をサポートする Item タイプに関連付けられた単一の選択肢(CheckboxItemListItemMultipleChoiceItem など)。

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
        item.createChoice('Dogs', FormApp.PageNavigationType.RESTART)
    ]);

// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');

// Log the navigation types that each choice results in.
var choices = item.getChoices();
for (var i = 0; i < choices.length; i++) {
Logger.log('If the respondent chooses "%s", the form will %s.',
           choices[i].getValue(),
           choices[i].getPageNavigationType());
}

Methods

メソッド戻り値の型概要
getGotoPage()PageBreakItemレスポンダーがこれを選択して現在のページを完了した場合、GO_TO_PAGE デスティネーションとして設定された PageBreakItem を取得します。
getPageNavigationType()PageNavigationType回答者がこの選択肢を選択して現在のページを完了した場合に発生する PageNavigationType を取得します。
getValue()String回答者がフォームを表示したときにラベルとして表示される選択肢の値を取得します。
isCorrectAnswer()Boolean選択が問題の正解かどうかを取得します。

詳細なドキュメント

getGotoPage()

レスポンダーがこれを選択して現在のページを完了した場合、GO_TO_PAGE デスティネーションとして設定された PageBreakItem を取得します。このメソッドは、MultipleChoiceItems に関連付けられた選択肢にのみ適用されます。それ以外の選択肢の場合は null を返します。

リターン

PageBreakItem - この選択の GO_TO_PAGE の宛先。ない場合は null

承認

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

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

getPageNavigationType()

回答者がこの選択肢を選択して現在のページを完了した場合に発生する PageNavigationType を取得します。このメソッドは、MultipleChoiceItems に関連付けられた選択肢にのみ適用され、それ以外の選択肢の場合は null を返します。

リターン

PageNavigationType - この選択のナビゲーション アクション。存在しない場合は null

承認

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

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

getValue()

回答者がフォームを表示したときにラベルとして表示される選択肢の値を取得します。

リターン

String - 選択の値

承認

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

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

isCorrectAnswer()

選択が問題の正解かどうかを取得します。このメソッドはクイズに含まれる質問にのみ適用されます。クイズ以外のフォームでは false が返されます。

リターン

Boolean - 選択が正解かどうか。

承認

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

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