Interface Item

Item

यह एक सामान्य फ़ॉर्म आइटम है. इसमें सभी आइटम के लिए सामान्य प्रॉपर्टी होती हैं. जैसे, टाइटल और सहायता टेक्स्ट. Form से आइटम ऐक्सेस किए जा सकते हैं या बनाए जा सकते हैं.

टाइप के हिसाब से प्रॉपर्टी पर कार्रवाई करने के लिए, getType() का इस्तेमाल करके आइटम के ItemType की जांच करें. इसके बाद, asCheckboxItem() जैसे किसी तरीके का इस्तेमाल करके, आइटम को सही क्लास में कास्ट करें.

// 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);
}

क्लास लागू करना

नामसंक्षिप्त विवरण

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
asCheckboxGridItem()CheckboxGridItemयह आइटम को चेकबॉक्स ग्रिड आइटम के तौर पर दिखाता है.
asCheckboxItem()CheckboxItemआइटम को चेकबॉक्स आइटम के तौर पर दिखाता है.
asDateItem()DateItemयह आइटम को तारीख के आइटम के तौर पर दिखाता है.
asDateTimeItem()DateTimeItemयह आइटम को तारीख और समय के आइटम के तौर पर दिखाता है.
asDurationItem()DurationItemयह फ़ंक्शन, आइटम को अवधि के आइटम के तौर पर दिखाता है.
asGridItem()GridItemयह आइटम को ग्रिड आइटम के तौर पर दिखाता है.
asImageItem()ImageItemयह आइटम को इमेज आइटम के तौर पर दिखाता है.
asListItem()ListItemयह आइटम को सूची के आइटम के तौर पर दिखाता है.
asMultipleChoiceItem()MultipleChoiceItemयह फ़ंक्शन, आइटम को जवाब के कई विकल्पों वाले आइटम के तौर पर दिखाता है.
asPageBreakItem()PageBreakItemयह आइटम को पेज ब्रेक आइटम के तौर पर दिखाता है.
asParagraphTextItem()ParagraphTextItemयह आइटम को पैराग्राफ़-टेक्स्ट आइटम के तौर पर दिखाता है.
asRatingItem()RatingItemयह आइटम को रेटिंग आइटम के तौर पर दिखाता है.
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()

यह आइटम को इमेज आइटम के तौर पर दिखाता है. अगर ItemType पहले से IMAGE नहीं था, तो यह स्क्रिप्टिंग से जुड़ा अपवाद दिखाता है.

वापसी का टिकट

ImageItem — इमेज आइटम

थ्रो

Error — अगर आइटम, इमेज आइटम नहीं है


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

asRatingItem()

यह आइटम को रेटिंग आइटम के तौर पर दिखाता है. अगर ItemType पहले से 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();

वापसी का टिकट

RatingItem — रेटिंग आइटम.

थ्रो

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

इस आइटम को वीडियो आइटम के तौर पर दिखाता है. अगर ItemType पहले से VIDEO नहीं था, तो यह स्क्रिप्टिंग से जुड़ा अपवाद दिखाता है.

वापसी का टिकट

VideoItem — वीडियो आइटम

थ्रो

Error — अगर आइटम कोई वीडियो आइटम नहीं है


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 जैसे लेआउट आइटम के लिए ब्यौरे वाला टेक्स्ट भी कहा जाता है.

पैरामीटर

नामटाइपब्यौरा
textStringनया सहायता टेक्स्ट

वापसी का टिकट

Item — यह Item, चेन बनाने के लिए

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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

setTitle(title)

इससे आइटम का टाइटल सेट किया जाता है. SectionHeaderItem के मामले में, इसे कभी-कभी हेडर टेक्स्ट भी कहा जाता है.

पैरामीटर

नामटाइपब्यौरा
titleStringनया टाइटल या हेडर टेक्स्ट

वापसी का टिकट

Item — यह Item, चेन बनाने के लिए

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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