Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
clearValidation()CheckboxGridItemइस ग्रिड आइटम के लिए, डेटा की पुष्टि करने की सुविधा हटाता है.
createResponse(responses)ItemResponseयह चेकबॉक्स ग्रिड आइटम के लिए, नया ItemResponse बनाता है.
duplicate()CheckboxGridItemइस आइटम की एक कॉपी बनाता है और उसे फ़ॉर्म के आखिर में जोड़ता है.
getColumns()String[]इससे ग्रिड में मौजूद हर कॉलम की वैल्यू मिलती है.
getHelpText()Stringइससे आइटम का सहायता टेक्स्ट मिलता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे का टेक्स्ट भी कहा जाता है.
getId()Integerयह फ़ंक्शन, आइटम का यूनीक आइडेंटिफ़ायर दिखाता है.
getIndex()Integerयह फ़ॉर्म में मौजूद सभी आइटम में से, आइटम का इंडेक्स दिखाता है.
getRows()String[]ग्रिड में मौजूद हर लाइन की वैल्यू मिलती है.
getTitle()Stringइससे आइटम का टाइटल मिलता है. कभी-कभी इसे हेडर टेक्स्ट भी कहा जाता है. ऐसा SectionHeaderItem के मामले में होता है.
getType()ItemTypeआइटम का टाइप मिलता है, जिसे ItemType के तौर पर दिखाया जाता है.
isRequired()Booleanयह कुकी तय करती है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setColumns(columns)CheckboxGridItemवैल्यू के कलेक्शन के आधार पर, ग्रिड के कॉलम सेट करता है.
setHelpText(text)CheckboxGridItemइस विकल्प की मदद से, आइटम के लिए सहायता टेक्स्ट सेट किया जाता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे वाला टेक्स्ट भी कहा जाता है.
setRequired(enabled)CheckboxGridItemइससे यह तय होता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना ज़रूरी है या नहीं.
setRows(rows)CheckboxGridItemयह फ़ंक्शन, वैल्यू के ऐरे के आधार पर ग्रिड की पंक्तियां सेट करता है.
setTitle(title)CheckboxGridItemइससे आइटम का टाइटल सेट किया जाता है. SectionHeaderItem के मामले में, इसे कभी-कभी हेडर टेक्स्ट भी कहा जाता है.
setValidation(validation)CheckboxGridItemइस चेकबॉक्स ग्रिड आइटम के लिए, डेटा की पुष्टि करने की सुविधा सेट करता है.

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

clearValidation()

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

वापसी का टिकट

CheckboxGridItem — यह आइटम, चेन बनाने के लिए है

अनुमति देना

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

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

createResponse(responses)

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

पैरामीटर

नामटाइपब्यौरा
responsesString[][]इस चेकबॉक्स ग्रिड आइटम के लिए मान्य जवाबों की कैटगरी की कैटगरी

वापसी का टिकट

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

अनुमति देना

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

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

duplicate()

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

वापसी का टिकट

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

अनुमति देना

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

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

getColumns()

इससे ग्रिड में मौजूद हर कॉलम की वैल्यू मिलती है.

वापसी का टिकट

String[] — कॉलम की वैल्यू का एक कलेक्शन. जवाब देने वाले लोगों को ये वैल्यू, फ़ॉर्म देखते समय लेबल के तौर पर दिखती हैं

अनुमति देना

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

  • 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

getRows()

ग्रिड में मौजूद हर लाइन की वैल्यू मिलती है.

वापसी का टिकट

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

अनुमति देना

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

  • 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

setColumns(columns)

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

पैरामीटर

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

वापसी का टिकट

CheckboxGridItem — यह आइटम, चेन बनाने के लिए है

थ्रॉ

Error — अगर दी गई सरणी null या खाली है

अनुमति देना

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

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

setHelpText(text)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setRequired(enabled)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setRows(rows)

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

पैरामीटर

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

वापसी का टिकट

CheckboxGridItem — यह आइटम, चेन बनाने के लिए है

थ्रॉ

Error — अगर दी गई सरणी null या खाली है

अनुमति देना

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

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

setTitle(title)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setValidation(validation)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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