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यह वह फ़ीडबैक दिखाता है जो किसी सवाल का सही जवाब देने पर, जवाब देने वाले लोगों को दिखता है.
getFeedbackForIncorrect()QuizFeedbackयह फ़ंक्शन, उस सुझाव/राय/शिकायत को दिखाता है जो किसी सवाल का गलत जवाब देने पर, जवाब देने वाले लोगों को दिखती है.
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 — सुझाव, राय या शिकायत, अगर कोई है.

अनुमति देना

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

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

getFeedbackForIncorrect()

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

वापसी का टिकट

QuizFeedback — सुझाव, राय या शिकायत, अगर कोई है.

अनुमति देना

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

  • 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