允許作答者從圓形按鈕清單中選取一個選項的問題項目,或
可選用的「其他」] 欄位。你可以透過 Form
存取或建立項目。用於
測驗,系統會自動為這些項目評分。
// Open a form by ID and add a new multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
方法
內容詳盡的說明文件
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
。如果
除非將 showOtherOption(enabled)
設為 true
,否則 response
引數不符合這個項目的有效選項。
參數
名稱 | 類型 | 說明 |
---|---|---|
response | String | 是這個選擇題的有效答案 |
回攻員
ItemResponse
:項目回應
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
建立此項目的副本並附加到表單結尾。
回攻員
MultipleChoiceItem
:與這個 MultipleChoiceItem
的重複項目,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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()
hasOtherOption()
判斷該項目是否含有「other」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇
回攻員
Boolean
- 如果項目有「其他」物件,則為 true
選項;如果不需要,則設為false
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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[] | 選擇值陣列,作答者在瀏覽表單時會顯示為標籤 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
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[] | 一組選項 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
擲回
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 | 新的意見回饋。空值會清除意見回饋。 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
設定當作答者答錯問題時,系統會顯示回應。
參數
名稱 | 類型 | 說明 |
---|---|---|
feedback | QuizFeedback | 新的意見回饋 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
設定項目的說明文字 (有時稱為 ImageItems
、PageBreakItems
和 SectionHeaderItems
等版面配置項目的說明文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
text | String | 新的說明文字 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
設定可評分項目的價值分數。新項目的預設值為 0。
參數
名稱 | 類型 | 說明 |
---|---|---|
points | Integer | 問題項目值多少分 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
設定作答者是否必須回答問題。
參數
名稱 | 類型 | 說明 |
---|---|---|
enabled | Boolean | 以及作答者是否需要回答問題 |
回攻員
MultipleChoiceItem
:目前的項目 (用於鏈結)
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
設定項目標題 (如果是 SectionHeaderItem
,有時稱為標題文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
title | String | 新的標題或標題文字 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
設定該項目是否含有「other」如果有需要 SQL 指令的分析工作負載
則 BigQuery 可能是最佳選擇新的 CheckboxItem
或
MultipleChoiceItem
為 false
。
參數
名稱 | 類型 | 說明 |
---|---|---|
enabled | Boolean | 如果項目有「其他」值,則為 true 選項;false 表示不滿意 |
回攻員
MultipleChoiceItem
:這個 MultipleChoiceItem
,用於鏈結
授權
使用這個方法的指令碼需要下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms