一般表單項目,內含所有項目的通用屬性,例如標題和說明文字。您可以透過 Form
存取或建立項目。
如要在類型專屬屬性上運作,請使用 getType()
檢查項目的 ItemType
,然後使用 asCheckboxItem()
等方法將項目投放到適當的類別。
// Create a new form and add a text item. var form = FormApp.create('Form Name'); form.addTextItem(); // Access the text item as a generic item. var items = form.getItems(); var item = items[0]; // Cast the generic item to the text-item class. if (item.getType() == 'TEXT') { var textItem = item.asTextItem(); textItem.setRequired(false); }
實作類別
名稱 | 簡短說明 |
---|
方法
內容詳盡的說明文件
asCheckboxGridItem()
傳回項目做為核取方塊格線項目。如果 ItemType
尚未 CHECKBOX_GRID
,就會擲回指令碼例外狀況。
回攻員
CheckboxGridItem
:核取方塊格線項目
擲回
Error
:如果項目不是核取方塊格線項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asCheckboxItem()
以核取方塊項目的形式傳回項目。如果 ItemType
尚未 CHECKBOX
,就會擲回指令碼例外狀況。
回攻員
CheckboxItem
:核取方塊項目
擲回
Error
— 如果該項目不是核取方塊項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateItem()
asDateTimeItem()
以日期時間項目的形式傳回項目。如果 ItemType
尚未 DATETIME
,就會擲回指令碼例外狀況。
回攻員
DateTimeItem
:日期時間項目
擲回
Error
:如果該項目不是日期時間項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDurationItem()
以期限項目的形式傳回商品。如果 ItemType
尚未 DURATION
,就會擲回指令碼例外狀況。
回攻員
DurationItem
:時間長度項目
擲回
Error
— 如果該項目不是時間長度項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asGridItem()
asImageItem()
asListItem()
asMultipleChoiceItem()
asPageBreakItem()
以分頁符號項目的形式傳回項目。如果 ItemType
尚未 PAGE_BREAK
,就會擲回指令碼例外狀況。
回攻員
PageBreakItem
:分頁符號項目
擲回
Error
— 如果項目不是分頁符號項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asParagraphTextItem()
以段落文字項目的形式傳回項目。如果 ItemType
尚未 PARAGRAPH_TEXT
,就會擲回指令碼例外狀況。
回攻員
ParagraphTextItem
:段落文字項目
擲回
Error
— 如果項目不是段落文字項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asScaleItem()
asSectionHeaderItem()
傳回項目做為區段標題項目。如果 ItemType
尚未 SECTION_HEADER
,就會擲回指令碼例外狀況。
回攻員
SectionHeaderItem
:區段標題項目
擲回
Error
:如果項目不是區段標題項目
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTextItem()
asTimeItem()
asVideoItem()
duplicate()
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
getTitle()
取得項目的標題 (在 SectionHeaderItem
中則稱為標題文字)。
回攻員
String
:項目的標題或標題文字
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
setHelpText(text)
設定項目的說明文字 (有時稱為 ImageItems
、PageBreakItems
和 SectionHeaderItems
等版面配置項目的說明文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
text | String | 新的說明文字 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
設定項目的標題 (在 SectionHeaderItem
中也稱為標題文字)。
參數
名稱 | 類型 | 說明 |
---|---|---|
title | String | 新的標題或標題文字 |
回攻員
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms