問題項目,可讓作答者從下拉式清單中選取一個選項。您可以透過 Form
存取或建立項目。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
方法
內容詳盡的說明文件
createChoice(value)
createChoice(value, isCorrect)
createChoice(value, navigationItem)
建立新選項,提供頁面導覽選項,讓您跳到指定分頁項目。這相當於 navigationType
設定為 FormApp.PageNavigationType.GO_TO_PAGE
的 createChoice(value, navigationType)
。使用頁面導覽的選項無法同時與不使用頁面導覽的選項合併。
作答者完成含有選項的頁面後,且只有在作答者選擇該選項時,系統才會瀏覽頁面。如果作答者在同一個頁面上使用頁面瀏覽操作說明選擇多個選項,則只有最後一個導覽選項會生效。瀏覽頁面也不會影響表單的最後一個頁面。
參數
名稱 | 類型 | 說明 |
---|---|---|
value | String | 作答者檢視表單時看到的標籤值 |
navigationItem | PageBreakItem | 即可前往 |
回攻員
Choice
:新選項
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
為這個清單項目建立新的 ItemResponse
。如果 response
引數與這個項目的有效選項不符,就會擲回例外狀況。
參數
名稱 | 類型 | 說明 |
---|---|---|
response | String | 這個清單項目的有效答案 |
回攻員
ItemResponse
:項目回應
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
getChoices()
getFeedbackForCorrect()
傳回作答者正確回答問題後會看到的意見回饋。
回攻員
QuizFeedback
:意見回饋 (如果有的話)。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
傳回作答者錯誤回答時看到的意見回饋。
回攻員
QuizFeedback
:意見回饋 (如果有的話)。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
取得項目的說明文字 (有時稱為 ImageItems
、PageBreakItems
和 SectionHeaderItems
等版面配置項目的說明文字)。
回攻員
String
:商品的說明文字或說明文字
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
取得項目的專屬 ID。
回攻員
Integer
:項目的 ID
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
取得表單中所有項目的索引。
回攻員
Integer
:項目的索引
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
傳回可評分項目的分數值。
回攻員
Integer
:問題可獲得的分數。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
取得項目的標題 (在 SectionHeaderItem
中則稱為標題文字)。
回攻員
String
:項目的標題或標題文字
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
決定作答者是否必須回答問題。
回攻員
Boolean
:作答者是否須回答問題
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
從字串陣列設定項目的選項。如果指定的陣列為空白,就會擲回例外狀況。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
參數
名稱 | 類型 | 說明 |
---|---|---|
values | String[] | 選擇值陣列,作答者在檢視表單時會顯示為標籤 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
設定項目的選項陣列。如果指定的陣列為空白或包含 null
元素,就會擲回例外狀況。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
參數
名稱 | 類型 | 說明 |
---|---|---|
choices | Choice[] | 一個選擇陣列 |
回攻員
擲回
Error
:如果指定陣列為 null
、空白或包含 null
元素
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
設定在作答者正確回答問題時,向他們顯示意見回饋。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
參數
名稱 | 類型 | 說明 |
---|---|---|
feedback | QuizFeedback | 新的意見回饋空值會清除意見回饋。 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
設定在作答者答錯時向他們顯示意見回饋。
參數
名稱 | 類型 | 說明 |
---|---|---|
feedback | QuizFeedback | 新的意見回饋 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
設定項目的說明文字 (有時稱為 ImageItems
、PageBreakItems
和 SectionHeaderItems
等版面配置項目的說明文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
text | String | 新的說明文字 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
setRequired(enabled)
setTitle(title)
設定項目的標題 (在 SectionHeaderItem
中也稱為標題文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
title | String | 新的標題或標題文字 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms