Class ScaleItem

ScaleItem

可讓作答者從編號序列中選擇一個選項的問題項目 按鈕。你可以透過 Form 存取或建立項目。用於測驗時，下列項目 是否已評分。

// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
    .setBounds(1, 10);

方法

方法	傳回類型	簡短說明
createResponse(response)	ItemResponse	為這個體重計項目建立新的 ItemResponse。
duplicate()	ScaleItem	建立此項目的副本並附加到表單結尾。
getGeneralFeedback()	QuizFeedback	傳回在作答者答對問題後顯示的意見回饋。
getHelpText()	String	取得項目的說明文字 (有時稱為 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目的說明文字)。
getId()	Integer	取得項目的專屬 ID。
getIndex()	Integer	取得表單中所有項目的項目索引。
getLeftLabel()	String	取得體重計下限的標籤 (如有)。
getLowerBound()	Integer	取得體重計的下限。
getPoints()	Integer	傳回可評分項目的分數值。
getRightLabel()	String	取得體重計上限的標籤 (如有)。
getTitle()	String	取得項目標題 (如果是 SectionHeaderItem，有時稱為標題文字)。
getType()	ItemType	取得項目的類型，以 ItemType 表示。
getUpperBound()	Integer	取得體重計的上限。
isRequired()	Boolean	決定作答者是否必須回答問題。
setBounds(lower, upper)	ScaleItem	設定體重計的下限和上限。
setGeneralFeedback(feedback)	ScaleItem	設定當作答者回答已評分的問題時，要顯示回應 答錯或不正確的答案 (例如需要手動評分的問題)。
setHelpText(text)	ScaleItem	設定項目的說明文字 (有時稱為 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目的說明文字)。
setLabels(lower, upper)	ScaleItem	設定體重計的下限和上限標籤。
setPoints(points)	ScaleItem	設定可評分項目的價值分數。
setRequired(enabled)	ScaleItem	設定作答者是否必須回答問題。
setTitle(title)	ScaleItem	設定項目標題 (如果是 SectionHeaderItem，有時稱為標題文字)。

內容詳盡的說明文件

createResponse(response)

為這個體重計項目建立新的 ItemResponse。如果 response 引數不在項目設定的邊界內，就會擲回例外狀況。

參數

名稱	類型	說明
response	Integer	這個比例項目的值答案

回攻員

ItemResponse：項目回應

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

duplicate()

建立此項目的副本並附加到表單結尾。

回攻員

ScaleItem：與這個 ScaleItem 的重複項目，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getGeneralFeedback()

傳回在作答者答對問題後顯示的意見回饋。

回攻員

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

---

getLeftLabel()

取得體重計下限的標籤 (如有)。

回攻員

String：體重計下限的標籤

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getLowerBound()

取得體重計的下限。

回攻員

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

---

getRightLabel()

取得體重計上限的標籤 (如有)。

回攻員

String：體重計上限的標籤

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• 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()

取得項目的類型，以 ItemType 表示。

回攻員

ItemType：項目的類型

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getUpperBound()

取得體重計的上限。

回攻員

Integer：體重計的上限

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• 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

---

setBounds(lower, upper)

設定體重計的下限和上限。下限必須為 0 或 1。 上限必須介於 3 和 10 之間 (含首尾)。新的體重計時，會預設使用 1 的下限和 5 上限。

如果指定的值超出允許的上限，就會擲回指令碼例外狀況。小數 會截斷至前一個整數。

參數

名稱	類型	說明
lower	Integer	新的下限
upper	Integer	新的上限

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

擲回

Error：如果下限或上限無效

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setGeneralFeedback(feedback)

設定當作答者回答已評分的問題時，要顯示回應 答錯或不正確的答案 (例如需要手動評分的問題)。

參數

名稱	類型	說明
feedback	QuizFeedback	新的意見回饋

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setHelpText(text)

設定項目的說明文字 (有時稱為 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目的說明文字)。

參數

名稱	類型	說明
text	String	新的說明文字

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setLabels(lower, upper)

設定體重計的下限和上限標籤。

參數

名稱	類型	說明
lower	String	針對下限值的新標籤
upper	String	範圍上限的新標籤

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setPoints(points)

設定可評分項目的價值分數。新項目的預設值為 0。

參數

名稱	類型	說明
points	Integer	問題項目值多少分

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setRequired(enabled)

設定作答者是否必須回答問題。

參數

名稱	類型	說明
enabled	Boolean	以及作答者是否需要回答問題

回攻員

ScaleItem：目前的項目 (用於鏈結)

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setTitle(title)

設定項目標題 (如果是 SectionHeaderItem，有時稱為標題文字)。

參數

名稱	類型	說明
title	String	新的標題或標題文字

回攻員

ScaleItem：這個 ScaleItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms