問題項目,允許作答者選取一或多個核取方塊,以及選填的「其他」欄位。您可以透過 Form
存取或建立項目。用於測驗時,系統會自動為這些項目評分。
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
方法
內容詳盡的說明文件
clearValidation()
移除這個核取方塊項目的所有資料驗證。
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
createChoice(value, isCorrect)
createResponse(responses)
為這個核取方塊項目建立新的 ItemResponse
。引數 responses
是 String[]
陣列,其中含有需要檢查的值。除非 showOtherOption(enabled)
設為 true
,否則如果任何值與這個項目的有效選項不符,就會擲回例外狀況。
參數
名稱 | 類型 | 說明 |
---|---|---|
responses | String[] | 這個選擇題的有效答案陣列 |
回攻員
ItemResponse
:項目回應
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
建立這個項目的副本,並附加到表單末尾。
回攻員
CheckboxItem
— 此 CheckboxItem
的重複項目,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
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()
決定項目是否提供「其他」選項。
回攻員
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[] | 選擇值陣列,作答者在檢視表單時會顯示為標籤 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
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[] | 一個選擇陣列 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
擲回
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 | 新的意見回饋空值會清除意見回饋。 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
設定在作答者答錯時向他們顯示意見回饋。
參數
名稱 | 類型 | 說明 |
---|---|---|
feedback | QuizFeedback | 新的意見回饋 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
設定項目的說明文字 (有時稱為 ImageItems
、PageBreakItems
和 SectionHeaderItems
等版面配置項目的說明文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
text | String | 新的說明文字 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
設定可評分項目的價值分數。新項目的預設值是 0。
參數
名稱 | 類型 | 說明 |
---|---|---|
points | Integer | 問題項目的價值分數 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
設定作答者是否必須回答問題。
參數
名稱 | 類型 | 說明 |
---|---|---|
enabled | Boolean | 作答者是否必須回答 |
回攻員
CheckboxItem
:目前的項目 (用於鏈結)
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
設定項目的標題 (在 SectionHeaderItem
中也稱為標題文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
title | String | 新的標題或標題文字 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
設定這個核取方塊項目的資料驗證。如果您傳入空值或驗證,且未呼叫任何必要函式,系統將移除任何先前的驗證。
參數
名稱 | 類型 | 說明 |
---|---|---|
validation | CheckboxValidation | 必須套用核取方塊驗證,才能套用至這個項目。 |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
設定項目是否提供「其他」選項。新 CheckboxItem
或 MultipleChoiceItem
的預設值為 false
。
參數
名稱 | 類型 | 說明 |
---|---|---|
enabled | Boolean | 如果項目有「其他」選項,則為 true ;否則為 false |
回攻員
CheckboxItem
— 此 CheckboxItem
,用於鏈結
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms