Interface Item

Item

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

टाइप पर आधारित प्रॉपर्टी पर काम करने के लिए, आइटम के ItemType की जांच करने के लिए getType() का इस्तेमाल करें. इसके बाद, 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