Class 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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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