Class GridItem

GridItem

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

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

तरीके

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

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

clearValidation()

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

वापसी का टिकट

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

अनुमति देना

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

  • 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()

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

वापसी का टिकट

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

अनुमति देना

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

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

वापसी का टिकट

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

थ्रो

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

अनुमति देना

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

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

setHelpText(text)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setRequired(enabled)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setRows(rows)

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

पैरामीटर

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

वापसी का टिकट

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

थ्रो

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

अनुमति देना

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

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

setTitle(title)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

setValidation(validation)

इस ग्रिड आइटम के लिए डेटा की पुष्टि करने की सुविधा सेट करता है. null या ऐसे GridValidation इंस्टेंस को पास करने पर, जिसमें ज़रूरी फ़ंक्शन कॉल नहीं किए गए हैं, पहले से मौजूद सभी मान्यताओं को हटा दिया जाता है.

पैरामीटर

नामटाइपब्यौरा
validationGridValidationइस आइटम पर लागू होने वाला GridValidation.

वापसी का टिकट

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

अनुमति देना

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

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