एक सामान्य फ़ॉर्म आइटम, जिसमें सभी आइटम के लिए सामान्य प्रॉपर्टी होती हैं. जैसे, टाइटल और सहायता टेक्स्ट.
आइटम को Form
से ऐक्सेस किया जा सकता है या बनाया जा सकता है.
टाइप पर आधारित प्रॉपर्टी पर काम करने के लिए, आइटम के Item
की जांच करने के लिए get
का इस्तेमाल करें. इसके बाद, as
जैसे तरीके का इस्तेमाल करके आइटम को सही क्लास में कास्ट करें.
// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();
// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];
// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
const textItem = item.asTextItem();
textItem.setRequired(false);
}
क्लास लागू करना
नाम | संक्षिप्त विवरण |
---|
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
as | Checkbox | आइटम को चेकबॉक्स ग्रिड आइटम के तौर पर दिखाता है. |
as | Checkbox | आइटम को चेकबॉक्स आइटम के तौर पर दिखाता है. |
as | Date | आइटम को तारीख के तौर पर दिखाता है. |
as | Date | आइटम को तारीख-समय के तौर पर दिखाता है. |
as | Duration | आइटम को अवधि वाले आइटम के तौर पर दिखाता है. |
as | Grid | आइटम को ग्रिड आइटम के तौर पर दिखाता है. |
as | Image | आइटम को इमेज आइटम के तौर पर दिखाता है. |
as | List | आइटम को सूची के आइटम के तौर पर दिखाता है. |
as | Multiple | आइटम को एक से ज़्यादा विकल्प वाले आइटम के तौर पर दिखाता है. |
as | Page | आइटम को पेज-ब्रेक आइटम के तौर पर दिखाता है. |
as | Paragraph | आइटम को पैराग्राफ़-टेक्स्ट आइटम के तौर पर दिखाता है. |
as | Rating | आइटम को रेटिंग आइटम के तौर पर दिखाता है. |
as | Scale | आइटम को स्केल आइटम के तौर पर दिखाता है. |
as | Section | आइटम को सेक्शन-हेडर आइटम के तौर पर दिखाता है. |
as | Text | आइटम को टेक्स्ट आइटम के तौर पर दिखाता है. |
as | Time | आइटम को टाइम आइटम के तौर पर दिखाता है. |
as | Video | आइटम को वीडियो आइटम के तौर पर दिखाता है. |
duplicate() | Item | इस आइटम की कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है. |
get | String | इससे आइटम का सहायता टेक्स्ट मिलता है. इसे कभी-कभी Image , Page , और Section जैसे लेआउट आइटम के लिए, ब्यौरा टेक्स्ट भी कहा जाता है. |
get | Integer | आइटम का यूनीक आइडेंटिफ़ायर पाता है. |
get | Integer | फ़ॉर्म में मौजूद सभी आइटम में से, आइटम का इंडेक्स दिखाता है. |
get | String | आइटम का टाइटल दिखाता है. Section के मामले में, इसे हेडर टेक्स्ट भी कहा जाता है. |
get | Item | आइटम का टाइप दिखाता है. इसे Item के तौर पर दिखाया जाता है. |
set | Item | आइटम का सहायता टेक्स्ट सेट करता है. इसे कभी-कभी Image , Page , और Section जैसे लेआउट आइटम के लिए, ब्यौरा टेक्स्ट भी कहा जाता है. |
set | Item | इससे आइटम का टाइटल सेट होता है. Section के मामले में, इसे हेडर टेक्स्ट भी कहा जाता है. |
ज़्यादा जानकारी वाला दस्तावेज़
asCheckboxGridItem()
आइटम को चेकबॉक्स ग्रिड आइटम के तौर पर दिखाता है. अगर Item
पहले से CHECKBOX_GRID
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Checkbox
— चेकबॉक्स ग्रिड आइटम
थ्रो
Error
— अगर आइटम, चेकबॉक्स ग्रिड आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asCheckboxItem()
आइटम को चेकबॉक्स आइटम के तौर पर दिखाता है. अगर Item
पहले से CHECKBOX
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Checkbox
— चेकबॉक्स आइटम
थ्रो
Error
— अगर आइटम चेकबॉक्स आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateItem()
आइटम को तारीख के तौर पर दिखाता है. अगर Item
पहले से DATE
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Date
— तारीख का आइटम
थ्रो
Error
— अगर आइटम, तारीख वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateTimeItem()
आइटम को तारीख-समय के तौर पर दिखाता है. अगर Item
पहले से DATETIME
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Date
— तारीख-समय आइटम
थ्रो
Error
— अगर आइटम, तारीख-समय वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDurationItem()
आइटम को अवधि वाले आइटम के तौर पर दिखाता है. अगर Item
पहले से DURATION
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Duration
— कुल समय का आइटम
थ्रो
Error
— अगर आइटम, अवधि वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asGridItem()
आइटम को ग्रिड आइटम के तौर पर दिखाता है. अगर Item
पहले से GRID
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Grid
— ग्रिड आइटम
थ्रो
Error
— अगर आइटम, ग्रिड आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asImageItem()
asListItem()
आइटम को सूची के आइटम के तौर पर दिखाता है. अगर Item
पहले से LIST
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
List
— सूची में शामिल आइटम
थ्रो
Error
— अगर आइटम, सूची में शामिल आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asMultipleChoiceItem()
आइटम को एक से ज़्यादा विकल्प वाले आइटम के तौर पर दिखाता है. अगर Item
पहले से MULTIPLE_CHOICE
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Multiple
— कई विकल्प वाला आइटम
थ्रो
Error
— अगर आइटम, एक से ज़्यादा विकल्प वाला आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asPageBreakItem()
आइटम को पेज-ब्रेक आइटम के तौर पर दिखाता है. अगर Item
पहले से PAGE_BREAK
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Page
— पेज ब्रेक आइटम
थ्रो
Error
— अगर आइटम, पेज ब्रेक आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asParagraphTextItem()
आइटम को पैराग्राफ़-टेक्स्ट आइटम के तौर पर दिखाता है. अगर Item
पहले से PARAGRAPH_TEXT
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Paragraph
— पैराग्राफ़-टेक्स्ट आइटम
थ्रो
Error
— अगर आइटम पैराग्राफ़ टेक्स्ट आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asRatingItem()
आइटम को रेटिंग आइटम के तौर पर दिखाता है. अगर Item
पहले से RATING
नहीं था, तो ScriptingException को दिखाता है.
// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');
// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];
// Convert the item to a rating item.
const ratingItem = item.asRatingItem();
वापसी का टिकट
Rating
— रेटिंग वाला आइटम.
थ्रो
Error
— अगर आइटम को रेटिंग नहीं दी गई है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asScaleItem()
आइटम को स्केल आइटम के तौर पर दिखाता है. अगर Item
पहले से SCALE
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Scale
— स्केल आइटम
थ्रो
Error
— अगर आइटम स्केल आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asSectionHeaderItem()
आइटम को सेक्शन-हेडर आइटम के तौर पर दिखाता है. अगर Item
पहले से SECTION_HEADER
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Section
— सेक्शन-हेडर आइटम
थ्रो
Error
— अगर आइटम, सेक्शन हेडर आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTextItem()
आइटम को टेक्स्ट आइटम के तौर पर दिखाता है. अगर Item
पहले से TEXT
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Text
— टेक्स्ट आइटम
थ्रो
Error
— अगर आइटम कोई टेक्स्ट आइटम नहीं है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTimeItem()
आइटम को टाइम आइटम के तौर पर दिखाता है. अगर Item
पहले से TIME
नहीं था, तो स्क्रिप्टिंग अपवाद दिखाता है.
वापसी का टिकट
Time
— समय का आइटम
थ्रो
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()
इससे आइटम का सहायता टेक्स्ट मिलता है. इसे कभी-कभी Image
, Page
, और Section
जैसे लेआउट आइटम के लिए, ब्यौरा टेक्स्ट भी कहा जाता है.
वापसी का टिकट
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()
आइटम का टाइटल दिखाता है. Section
के मामले में, इसे हेडर टेक्स्ट भी कहा जाता है.
वापसी का टिकट
String
— आइटम का टाइटल या हेडर टेक्स्ट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
आइटम का टाइप दिखाता है. इसे Item
के तौर पर दिखाया जाता है.
वापसी का टिकट
Item
— आइटम का टाइप
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
आइटम का सहायता टेक्स्ट सेट करता है. इसे कभी-कभी Image
, Page
, और Section
जैसे लेआउट आइटम के लिए, ब्यौरा टेक्स्ट भी कहा जाता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
text | String | नया सहायता टेक्स्ट |
वापसी का टिकट
Item
— चेन बनाने के लिए यह Item
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
इससे आइटम का टाइटल सेट होता है. Section
के मामले में, इसे हेडर टेक्स्ट भी कहा जाता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
title | String | नया टाइटल या हेडर टेक्स्ट |
वापसी का टिकट
Item
— चेन बनाने के लिए यह Item
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms