Class CheckboxItem

CheckboxItem

यह एक सवाल वाला आइटम है. इसमें जवाब देने वाले व्यक्ति को एक या उससे ज़्यादा चेकबॉक्स चुनने की अनुमति होती है. साथ ही, इसमें "अन्य" फ़ील्ड भी होता है, जिसे भरना ज़रूरी नहीं होता. आइटम, Form से बनाए या ऐक्सेस किए जाते हैं. इसके लिए, Form.addCheckboxItem() जैसे तरीकों का इस्तेमाल किया जाता है. क्विज़ में इस्तेमाल किए जाने पर, इन आइटम को अपने-आप ग्रेड मिल जाता है. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
clearValidation()CheckboxItemइस चेकबॉक्स आइटम के लिए, डेटा की पुष्टि करने की सुविधा हटाता है.
createChoice(value)Choiceयह नया विकल्प बनाता है.
createChoice(value, isCorrect)Choiceयह नया विकल्प बनाता है.
createResponse(responses)ItemResponseयह चेकबॉक्स आइटम के लिए, नया ItemResponse बनाता है.
duplicate()CheckboxItemइस आइटम की एक कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है.
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 के तौर पर दिखाया जाता है.
hasOtherOption()Booleanयह कुकी तय करती है कि आइटम में "अन्य" विकल्प है या नहीं.
isRequired()Booleanयह कुकी तय करती है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setChoiceValues(values)CheckboxItemयह फ़ंक्शन, स्ट्रिंग के ऐरे से किसी आइटम के लिए विकल्प सेट करता है.
setChoices(choices)CheckboxItemकिसी आइटम के लिए विकल्पों का कलेक्शन सेट करता है.
setFeedbackForCorrect(feedback)CheckboxItemयह कुकी, जवाब देने वाले लोगों को वह फ़ीडबैक दिखाती है जो उन्हें किसी सवाल का सही जवाब देने पर दिखाया जाता है.
setFeedbackForIncorrect(feedback)CheckboxItemइस विकल्प का इस्तेमाल करके, जवाब देने वाले लोगों को वह फ़ीडबैक दिखाया जाता है जो किसी सवाल का गलत जवाब देने पर दिखता है.
setHelpText(text)CheckboxItemइस विकल्प की मदद से, आइटम के लिए सहायता टेक्स्ट सेट किया जाता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे वाला टेक्स्ट भी कहा जाता है.
setPoints(points)CheckboxItemइससे, ग्रेड दिए जा सकने वाले किसी आइटम के लिए पॉइंट की संख्या सेट की जाती है.
setRequired(enabled)CheckboxItemइससे यह तय होता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setTitle(title)CheckboxItemइससे आइटम का टाइटल सेट किया जाता है. SectionHeaderItem के मामले में, इसे कभी-कभी हेडर टेक्स्ट भी कहा जाता है.
setValidation(validation)CheckboxItemयह चेकबॉक्स आइटम के लिए, डेटा की पुष्टि करने की सुविधा सेट करता है.
showOtherOption(enabled)CheckboxItemइससे यह तय होता है कि आइटम में "अन्य" विकल्प है या नहीं.

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

clearValidation()

इस चेकबॉक्स आइटम के लिए, डेटा की पुष्टि करने की सुविधा हटाता है.

वापसी का टिकट

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

अनुमति देना

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

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

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

createResponse(responses)

यह चेकबॉक्स आइटम के लिए, नया ItemResponse बनाता है. आर्ग्युमेंट responses, एक String[] अरे है. इसमें वे वैल्यू शामिल होती हैं जिनकी जांच करनी है. अगर कोई भी वैल्यू इस आइटम के लिए मान्य विकल्प से मेल नहीं खाती है, तो एक अपवाद दिखाता है. हालांकि, ऐसा तब तक होता है, जब तक showOtherOption(enabled) को true पर सेट नहीं किया जाता.

पैरामीटर

नामटाइपब्यौरा
responsesString[]इस कई विकल्पों वाले आइटम के लिए, मान्य जवाबों की एक ऐरे

वापसी का टिकट

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

अनुमति देना

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

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

duplicate()

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

वापसी का टिकट

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

अनुमति देना

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

  • 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

hasOtherOption()

यह कुकी तय करती है कि आइटम में "अन्य" विकल्प है या नहीं.

वापसी का टिकट

Boolean — अगर आइटम में "अन्य" विकल्प है, तो true; अगर नहीं है, तो false

अनुमति देना

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

  • 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[]चुनी गई वैल्यू का कलेक्शन. जवाब देने वाले लोग, फ़ॉर्म देखते समय इन्हें लेबल के तौर पर देखते हैं

वापसी का टिकट

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

अनुमति देना

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

  • 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[]कई विकल्प

वापसी का टिकट

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

थ्रॉ

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().setText('Dogs rule, cats drool.').build(),
);

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setFeedbackForIncorrect(feedback)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setHelpText(text)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setPoints(points)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setRequired(enabled)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setTitle(title)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setValidation(validation)

यह चेकबॉक्स आइटम के लिए, डेटा की पुष्टि करने की सुविधा सेट करता है. शून्य या बिना किसी ज़रूरी फ़ंक्शन के पुष्टि करने की सुविधा चालू करने पर, पहले की गई पुष्टि हट जाएगी.

पैरामीटर

नामटाइपब्यौरा
validationCheckboxValidationइस आइटम पर लागू करने के लिए, CheckboxValidation.

वापसी का टिकट

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

अनुमति देना

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

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

showOtherOption(enabled)

इससे यह तय होता है कि आइटम में "अन्य" विकल्प है या नहीं. नए CheckboxItem या MultipleChoiceItem के लिए डिफ़ॉल्ट वैल्यू false होती है.

पैरामीटर

नामटाइपब्यौरा
enabledBooleanअगर आइटम में "अन्य" विकल्प है, तो true; अगर नहीं है, तो false

वापसी का टिकट

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

अनुमति देना

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

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