Class Choice

選択肢

CheckboxItemListItemMultipleChoiceItem などの選択肢をサポートする Item の種類に関連付けられた単一の選択肢。

// 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