Class ScaleItem

縮放項目

這類問題項目可讓作答者從一組編號圓形按鈕中選擇一個選項。您可以透過 Form 存取或建立項目。在測驗中使用時，這些項目會獲得評分。

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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