Class ListItem

ListItem

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

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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