फ़ॉर्म का एक सामान्य आइटम, जिसमें टाइटल और सहायता टेक्स्ट जैसी प्रॉपर्टी, सभी आइटम के लिए एक जैसी होती हैं.
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() | CheckboxGridItem | आइटम को चेकबॉक्स ग्रिड आइटम के तौर पर दिखाता है. |
asCheckboxItem() | CheckboxItem | चेकबॉक्स वाले आइटम के तौर पर आइटम को लौटाता है. |
asDateItem() | DateItem | आइटम को तारीख वाले आइटम के तौर पर दिखाता है. |
asDateTimeItem() | DateTimeItem | आइटम को तारीख-समय वाले आइटम के तौर पर दिखाता है. |
asDurationItem() | DurationItem | आइटम को कुल समय के तौर पर दिखाता है. |
asGridItem() | GridItem | यह आइटम को ग्रिड आइटम के तौर पर दिखाता है. |
asImageItem() | ImageItem | आइटम को इमेज आइटम के तौर पर लौटाता है. |
asListItem() | ListItem | आइटम को सूची आइटम के रूप में लौटाता है. |
asMultipleChoiceItem() | MultipleChoiceItem | यह विकल्प, आइटम को कई विकल्प वाले आइटम के तौर पर दिखाता है. |
asPageBreakItem() | PageBreakItem | आइटम को पेज-ब्रेक आइटम के तौर पर लौटाता है. |
asParagraphTextItem() | ParagraphTextItem | आइटम को पैराग्राफ़-टेक्स्ट आइटम के तौर पर दिखाता है. |
asScaleItem() | ScaleItem | आइटम को स्केल आइटम के तौर पर लौटाता है. |
asSectionHeaderItem() | SectionHeaderItem | आइटम को सेक्शन-हेडर आइटम के तौर पर दिखाता है. |
asTextItem() | TextItem | आइटम को टेक्स्ट आइटम के रूप में लौटाता है. |
asTimeItem() | TimeItem | समय के आइटम के तौर पर आइटम लौटाता है. |
asVideoItem() | VideoItem | यह आइटम को वीडियो आइटम के तौर पर दिखाता है. |
duplicate() | Item | इस आइटम की कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है. |
getHelpText() | String | आइटम का सहायता टेक्स्ट दिखाता है (कभी-कभी इसे ImageItems , PageBreakItems , और SectionHeaderItems जैसे लेआउट आइटम के लिए, जानकारी वाला टेक्स्ट भी कहा जाता है). |
getId() | Integer | आइटम का यूनीक आइडेंटिफ़ायर मिलता है. |
getIndex() | Integer | फ़ॉर्म में मौजूद सभी आइटम के बीच, आइटम के इंडेक्स की जानकारी देता है. |
getTitle() | String | इससे आइटम का टाइटल पता चलता है. SectionHeaderItem के मामले में, कभी-कभी इसे हेडर टेक्स्ट भी कहा जाता है. |
getType() | ItemType | आइटम का टाइप दिखाता है, जिसे ItemType के तौर पर दिखाया जाता है. |
setHelpText(text) | Item | आइटम का सहायता टेक्स्ट सेट करता है. इसे कभी-कभी ImageItems , PageBreakItems , और SectionHeaderItems जैसे लेआउट आइटम के लिए, जानकारी वाला टेक्स्ट भी कहा जाता है. |
setTitle(title) | Item | आइटम का शीर्षक सेट करता है (SectionHeaderItem के मामले में, कभी-कभी इसे हेडर टेक्स्ट कहा जाता है). |
ज़्यादा जानकारी के साथ दस्तावेज़
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()
आइटम को तारीख वाले आइटम के तौर पर दिखाता है. अगर ItemType
पहले से DATE
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
DateItem
— तारीख वाला आइटम
थ्रो
Error
— अगर आइटम, तारीख वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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()
यह आइटम को ग्रिड आइटम के तौर पर दिखाता है. अगर ItemType
पहले से GRID
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
GridItem
— ग्रिड आइटम
थ्रो
Error
— अगर आइटम, ग्रिड आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asImageItem()
asListItem()
आइटम को सूची आइटम के रूप में लौटाता है. अगर ItemType
पहले से LIST
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
ListItem
— सूची आइटम
थ्रो
Error
— अगर आइटम, सूची में शामिल आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asMultipleChoiceItem()
यह विकल्प, आइटम को कई विकल्प वाले आइटम के तौर पर दिखाता है. अगर ItemType
पहले से MULTIPLE_CHOICE
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
MultipleChoiceItem
— कई विकल्पों वाले आइटम
थ्रो
Error
— अगर आइटम एक से ज़्यादा विकल्प वाला आइटम न हो
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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()
आइटम को स्केल आइटम के तौर पर लौटाता है. अगर ItemType
पहले से SCALE
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
ScaleItem
— स्केल आइटम
थ्रो
Error
— अगर आइटम, स्केल वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asSectionHeaderItem()
आइटम को सेक्शन-हेडर आइटम के तौर पर दिखाता है. अगर ItemType
पहले से SECTION_HEADER
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
SectionHeaderItem
— सेक्शन हेडर आइटम
थ्रो
Error
— अगर आइटम, सेक्शन हेडर आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTextItem()
आइटम को टेक्स्ट आइटम के रूप में लौटाता है. अगर ItemType
पहले से TEXT
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
TextItem
— टेक्स्ट आइटम
थ्रो
Error
— अगर आइटम कोई टेक्स्ट आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTimeItem()
समय के आइटम के तौर पर आइटम लौटाता है. अगर ItemType
पहले से TIME
नहीं है, तो स्क्रिप्टिंग अपवाद फेंकता है.
रिटर्न
TimeItem
— समय आइटम
थ्रो
Error
— अगर आइटम, समय का आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asVideoItem()
duplicate()
इस आइटम की कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है.
रिटर्न
चेन बनाने के लिए, Item
इस Item
का डुप्लीकेट है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
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()
आइटम का यूनीक आइडेंटिफ़ायर मिलता है.
रिटर्न
Integer
— आइटम का आईडी
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
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()
आइटम का टाइप दिखाता है, जिसे ItemType
के तौर पर दिखाया जाता है.
रिटर्न
ItemType
— आइटम का टाइप
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
आइटम का सहायता टेक्स्ट सेट करता है. इसे कभी-कभी ImageItems
, PageBreakItems
, और SectionHeaderItems
जैसे लेआउट आइटम के लिए, जानकारी वाला टेक्स्ट भी कहा जाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
text | String | नया सहायता टेक्स्ट |
रिटर्न
Item
— यह Item
, चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
आइटम का शीर्षक सेट करता है (SectionHeaderItem
के मामले में, कभी-कभी इसे हेडर टेक्स्ट कहा जाता है).
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
title | String | नया शीर्षक या हेडर टेक्स्ट |
रिटर्न
Item
— यह Item
, चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms