Class 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 या कोई वैल्यू डालने पर या वैल्यू की पुष्टि करने के लिए, ज़रूरी फ़ंक्शन को कॉल किए बिना पुष्टि करने पर, पहले की गई पुष्टि हट जाएगी.

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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