Class ParagraphTextItem

ParagraphTextItem

問題項目，可讓受訪者輸入一段文字。您可以透過 Form 存取或建立項目。在測驗中使用時，系統會為這些項目評分。

// Open a form by ID and add a new paragraph text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addParagraphTextItem();
item.setTitle('What is your address?');

方法

方法	傳回類型	簡短說明
clearValidation()	ParagraphTextItem	移除這段文字項目的所有資料驗證。
createResponse(response)	ItemResponse	為這個段落文字項目建立新的 ItemResponse。
duplicate()	ParagraphTextItem	建立這個項目的副本，並附加到表單結尾。
getGeneralFeedback()	QuizFeedback	傳回受訪者回答可評分問題時看到的意見回饋。
getHelpText()	String	取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。
getId()	Integer	取得項目的專屬 ID。
getIndex()	Integer	取得表單中所有項目中的項目索引。
getPoints()	Integer	傳回可評分項目的點數值。
getTitle()	String	取得項目的標題 (如果是 SectionHeaderItem，有時稱為標題文字)。
getType()	ItemType	取得項目的類型，以 ItemType 表示。
isRequired()	Boolean	決定受訪者是否必須回答問題。
setGeneralFeedback(feedback)	ParagraphTextItem	設定作答者回答沒有正確或錯誤答案的評分問題時，系統顯示的意見回饋 (即需要手動評分的問題)。
setHelpText(text)	ParagraphTextItem	設定項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。
setPoints(points)	ParagraphTextItem	設定可評分項目的分數。
setRequired(enabled)	ParagraphTextItem	設定受訪者是否必須回答問題。
setTitle(title)	ParagraphTextItem	設定項目的標題 (如果是 SectionHeaderItem，有時稱為標題文字)。
setValidation(validation)	ParagraphTextItem	為這個段落文字項目設定資料驗證。

內容詳盡的說明文件

clearValidation()

移除這段文字項目的所有資料驗證。

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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

---

createResponse(response)

為這個段落文字項目建立新的 ItemResponse。

參數

名稱	類型	說明
response	String	回答項目提出的問題

回攻員

ItemResponse - 項目回應

授權

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

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

---

duplicate()

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

回攻員

ParagraphTextItem：這個 ParagraphTextItem 的副本，用於鏈結

授權

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

• 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

---

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

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

回攻員

ItemType：項目的類型

授權

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

• 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

---

setGeneralFeedback(feedback)

設定作答者回答沒有正確或錯誤答案的評分問題時，系統顯示的意見回饋 (即需要手動評分的問題)。

參數

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

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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

---

setHelpText(text)

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

參數

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

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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

---

setPoints(points)

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

參數

名稱	類型	說明
points	Integer	問題項目的分數

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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

---

setRequired(enabled)

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

參數

名稱	類型	說明
enabled	Boolean	受訪者是否必須回答問題

回攻員

ParagraphTextItem - 目前項目 (用於鏈結)

授權

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

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

---

setTitle(title)

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

參數

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

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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

---

setValidation(validation)

為這段文字項目設定資料驗證。傳遞 null 或未呼叫任何必要函式的 ParagraphTextValidation 例項，會移除任何先前的驗證。

參數

名稱	類型	說明
validation	ParagraphTextValidation	要套用至這個項目的 ParagraphTextValidation。

回攻員

ParagraphTextItem - this ParagraphTextItem，用於鏈結

授權

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

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