Class ListItem

ListItem

यह एक ऐसा सवाल होता है जिसमें जवाब देने वाले व्यक्ति को ड्रॉप-डाउन सूची से कोई एक विकल्प चुनने की अनुमति होती है. Form से आइटम ऐक्सेस किए जा सकते हैं या बनाए जा सकते हैं. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
createChoice(value)Choiceयह नया विकल्प बनाता है.
createChoice(value, isCorrect)Choiceयह नया विकल्प बनाता है.
createChoice(value, navigationItem)Choiceयह पेज पर नेविगेट करने का विकल्प वाला एक नया विकल्प बनाता है. इससे पेज ब्रेक वाले किसी आइटम पर जाया जा सकता है.
createChoice(value, navigationType)Choiceइससे पेज पर नेविगेट करने के विकल्प के साथ एक नया विकल्प बनता है.
createResponse(response)ItemResponseयह इस सूची के आइटम के लिए, नया ItemResponse बनाता है.
duplicate()ListItemइस आइटम की एक कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है.
getChoices()Choice[]किसी आइटम के लिए सभी विकल्प मिलते हैं.
getFeedbackForCorrect()QuizFeedback|nullयह कुकी, जवाब देने वाले लोगों को वह सुझाव दिखाती है जो किसी सवाल का सही जवाब देने पर दिखता है.
getFeedbackForIncorrect()QuizFeedback|nullयह फ़ंक्शन, जवाब देने वाले लोगों को वह सुझाव दिखाता है जो किसी सवाल का गलत जवाब देने पर दिखता है.
getHelpText()Stringइससे आइटम का सहायता टेक्स्ट मिलता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे का टेक्स्ट भी कहा जाता है.
getId()Integerयह फ़ंक्शन, आइटम का यूनीक आइडेंटिफ़ायर दिखाता है.
getIndex()Integerयह फ़ॉर्म में मौजूद सभी आइटम में से, आइटम का इंडेक्स दिखाता है.
getPoints()Integerग्रेड किए जा सकने वाले किसी आइटम की पॉइंट वैल्यू दिखाता है.
getTitle()Stringइससे आइटम का टाइटल मिलता है. कभी-कभी इसे हेडर टेक्स्ट भी कहा जाता है. ऐसा SectionHeaderItem के मामले में होता है.
getType()ItemTypeआइटम का टाइप मिलता है. इसे ItemType के तौर पर दिखाया जाता है.
isRequired()Booleanइस कुकी से यह तय किया जाता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setChoiceValues(values)ListItemयह फ़ंक्शन, स्ट्रिंग की किसी ऐरे से किसी आइटम के लिए विकल्प सेट करता है.
setChoices(choices)ListItemकिसी आइटम के लिए विकल्पों का कलेक्शन सेट करता है.
setFeedbackForCorrect(feedback)ListItemयह कुकी, जवाब देने वाले लोगों को वह फ़ीडबैक दिखाती है जो उन्हें किसी सवाल का सही जवाब देने पर दिखाया जाता है.
setFeedbackForIncorrect(feedback)ListItemइस विकल्प का इस्तेमाल करके, यह तय किया जाता है कि किसी सवाल का गलत जवाब देने पर, जवाब देने वाले लोगों को कौनसी जानकारी दिखाई जाएगी.
setHelpText(text)ListItemइस विकल्प का इस्तेमाल करके, आइटम के लिए सहायता टेक्स्ट सेट किया जाता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे वाला टेक्स्ट भी कहा जाता है.
setPoints(points)ListItemइससे, ग्रेड दिए जा सकने वाले किसी आइटम के लिए पॉइंट की संख्या सेट की जाती है.
setRequired(enabled)ListItemइससे यह तय होता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setTitle(title)ListItemइससे आइटम का टाइटल सेट किया जाता है. SectionHeaderItem के मामले में, इसे कभी-कभी हेडर टेक्स्ट भी कहा जाता है.

ज़्यादा जानकारी वाला दस्तावेज़

createChoice(value)

यह नया विकल्प बनाता है.

पैरामीटर

नामटाइपब्यौरा
valueStringविकल्प की वैल्यू, जो जवाब देने वाले लोगों को फ़ॉर्म देखते समय लेबल के तौर पर दिखती है

वापसी का टिकट

Choice — नया विकल्प

अनुमति देना

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

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

createChoice(value, isCorrect)

यह नया विकल्प बनाता है.

पैरामीटर

नामटाइपब्यौरा
valueStringविकल्प की वैल्यू, जो जवाब देने वाले लोगों को फ़ॉर्म देखते समय लेबल के तौर पर दिखती है
isCorrectBooleanयह विकल्प सही जवाब है या नहीं

वापसी का टिकट

Choice — नया विकल्प

अनुमति देना

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

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

createChoice(value, navigationItem)

यह पेज पर नेविगेट करने का विकल्प वाला एक नया विकल्प बनाता है. इससे पेज ब्रेक वाले किसी आइटम पर जाया जा सकता है. यह createChoice(value, navigationType) के बराबर है. इसमें navigationType को FormApp.PageNavigationType.GO_TO_PAGE पर सेट किया गया है. पेज नेविगेशन का इस्तेमाल करने वाले विकल्पों को, पेज नेविगेशन का इस्तेमाल न करने वाले विकल्पों के साथ एक ही आइटम में नहीं जोड़ा जा सकता.

जवाब देने वाला व्यक्ति, जिस पेज पर यह विकल्प मौजूद है उसे पूरा करने के बाद ही अगले पेज पर जा सकता है. हालांकि, ऐसा सिर्फ़ तब होगा, जब उसने उस विकल्प को चुना हो. अगर जवाब देने वाले व्यक्ति ने एक ही पेज पर, पेज पर नेविगेट करने के निर्देशों के साथ कई विकल्प चुने हैं, तो सिर्फ़ आखिरी नेविगेशन विकल्प का असर होगा. पेज पर नेविगेट करने की सुविधा का इस्तेमाल करने पर भी, फ़ॉर्म के आखिरी पेज पर कोई असर नहीं पड़ता.

पैरामीटर

नामटाइपब्यौरा
valueStringविकल्प की वैल्यू, जो जवाब देने वाले लोगों को फ़ॉर्म देखते समय लेबल के तौर पर दिखती है
navigationItemPageBreakItemवह आइटम जिस पर नेविगेट करना है

वापसी का टिकट

Choice — नया विकल्प

अनुमति देना

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

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

createChoice(value, navigationType)

इससे पेज पर नेविगेट करने के विकल्प के साथ एक नया विकल्प बनता है. पेज नेविगेशन का इस्तेमाल करने वाले विकल्पों को, पेज नेविगेशन का इस्तेमाल न करने वाले विकल्पों के साथ एक ही आइटम में नहीं जोड़ा जा सकता.

जवाब देने वाला व्यक्ति, जिस पेज पर यह विकल्प मौजूद है उसे पूरा करने के बाद ही अगले पेज पर जा सकता है. हालांकि, ऐसा सिर्फ़ तब होगा, जब उसने उस विकल्प को चुना हो. अगर जवाब देने वाले व्यक्ति ने एक ही पेज पर, पेज पर नेविगेट करने के निर्देशों के साथ कई विकल्प चुने हैं, तो सिर्फ़ आखिरी नेविगेशन विकल्प का असर होगा. पेज पर नेविगेट करने की सुविधा का इस्तेमाल करने पर भी, फ़ॉर्म के आखिरी पेज पर कोई असर नहीं पड़ता.

पैरामीटर

नामटाइपब्यौरा
valueStringविकल्प की वैल्यू, जो जवाब देने वाले लोगों को फ़ॉर्म देखते समय लेबल के तौर पर दिखती है
navigationTypePageNavigationTypeविकल्प के नेविगेशन का टाइप

वापसी का टिकट

Choice — नया विकल्प

अनुमति देना

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

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

createResponse(response)

यह इस सूची के आइटम के लिए, नया ItemResponse बनाता है. अगर response आर्ग्युमेंट, इस आइटम के लिए मान्य विकल्प से मेल नहीं खाता है, तो यह फ़ंक्शन एक अपवाद दिखाता है.

पैरामीटर

नामटाइपब्यौरा
responseStringइस सूची के आइटम के लिए मान्य जवाब

वापसी का टिकट

ItemResponse — आइटम का जवाब

अनुमति देना

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

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

duplicate()

इस आइटम की एक कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है.

वापसी का टिकट

ListItem — यह ListItem का डुप्लीकेट है, ताकि इसे चेन किया जा सके

अनुमति देना

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

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

getChoices()

किसी आइटम के लिए सभी विकल्प मिलते हैं.

वापसी का टिकट

Choice[] — विकल्पों की एक सीरीज़

अनुमति देना

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

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

getFeedbackForCorrect()

यह कुकी, जवाब देने वाले लोगों को वह सुझाव दिखाती है जो किसी सवाल का सही जवाब देने पर दिखता है.

वापसी का टिकट

QuizFeedback|null — अगर कोई सुझाव/राय देनी है या शिकायत करनी है, तो यहां लिखें.

अनुमति देना

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

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

getFeedbackForIncorrect()

यह फ़ंक्शन, जवाब देने वाले लोगों को वह सुझाव दिखाता है जो किसी सवाल का गलत जवाब देने पर दिखता है.

वापसी का टिकट

QuizFeedback|null — अगर कोई सुझाव/राय देनी है या शिकायत करनी है, तो यहां लिखें.

अनुमति देना

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

  • 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

getPoints()

ग्रेड किए जा सकने वाले किसी आइटम की पॉइंट वैल्यू दिखाता है.

वापसी का टिकट

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

isRequired()

इस कुकी से यह तय किया जाता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.

वापसी का टिकट

Boolean — इससे यह तय होता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं

अनुमति देना

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

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

setChoiceValues(values)

यह फ़ंक्शन, स्ट्रिंग की किसी ऐरे से किसी आइटम के लिए विकल्प सेट करता है. अगर दी गई ऐरे खाली है, तो यह फ़ंक्शन एक अपवाद दिखाता है. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

पैरामीटर

नामटाइपब्यौरा
valuesString[]चुनी गई वैल्यू का कलेक्शन. जवाब देने वाले लोग, फ़ॉर्म देखते समय इन्हें लेबल के तौर पर देखते हैं

वापसी का टिकट

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

अनुमति देना

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

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

setChoices(choices)

किसी आइटम के लिए विकल्पों का कलेक्शन सेट करता है. अगर दी गई कैटगरी खाली है या उसमें null एलिमेंट मौजूद है, तो यह फ़ंक्शन एक अपवाद दिखाता है. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

पैरामीटर

नामटाइपब्यौरा
choicesChoice[]कई विकल्प

वापसी का टिकट

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

थ्रो

Error — अगर दी गई सरणी null है, खाली है या इसमें null एलिमेंट शामिल है

अनुमति देना

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

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

setFeedbackForCorrect(feedback)

यह कुकी, जवाब देने वाले लोगों को वह फ़ीडबैक दिखाती है जो उन्हें किसी सवाल का सही जवाब देने पर दिखाया जाता है. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

पैरामीटर

नामटाइपब्यौरा
feedbackQuizFeedbackनया सुझाव/राय या शिकायत. शून्य वैल्यू से सुझाव मिट जाएगा.

वापसी का टिकट

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

अनुमति देना

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

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

setFeedbackForIncorrect(feedback)

इस विकल्प का इस्तेमाल करके, यह तय किया जाता है कि किसी सवाल का गलत जवाब देने पर, जवाब देने वाले लोगों को कौनसी जानकारी दिखाई जाएगी.

पैरामीटर

नामटाइपब्यौरा
feedbackQuizFeedbackनया सुझाव/राय/शिकायत

वापसी का टिकट

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

अनुमति देना

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

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

setHelpText(text)

इस विकल्प का इस्तेमाल करके, आइटम के लिए सहायता टेक्स्ट सेट किया जाता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे वाला टेक्स्ट भी कहा जाता है.

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setPoints(points)

इससे, ग्रेड दिए जा सकने वाले किसी आइटम के लिए पॉइंट की संख्या सेट की जाती है. नए आइटम के लिए, डिफ़ॉल्ट वैल्यू 0 होती है.

पैरामीटर

नामटाइपब्यौरा
pointsIntegerकिसी सवाल के लिए मिलने वाले पॉइंट की संख्या

वापसी का टिकट

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

अनुमति देना

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

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

setRequired(enabled)

इससे यह तय होता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.

पैरामीटर

नामटाइपब्यौरा
enabledBooleanक्या जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है

वापसी का टिकट

ListItem — मौजूदा आइटम (चेनिंग के लिए)

अनुमति देना

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

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

setTitle(title)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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