允許作答者從下拉式清單中選取一個選項的問題項目。項目可以
可以透過 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