सवालों के एक आइटम को कॉलम और पंक्तियों के ग्रिड के तौर पर दिखाया जाता है. इसकी मदद से जवाब देने वाला व्यक्ति चेकबॉक्स के क्रम से हर पंक्ति में कई विकल्प चुन सकता है. Form
की मदद से, आइटम बनाए या ऐक्सेस किए जा सकते हैं.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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
एलिमेंट, उस पंक्ति में कोई जवाब नहीं दिखाता है. अगर कोई भी वैल्यू किसी मान्य विकल्प से मेल नहीं खाती है, तो यह अपवाद देता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
responses | String[][] | इस चेकबॉक्स ग्रिड आइटम के लिए मान्य जवाबों का कलेक्शन |
रिटर्न
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)
वैल्यू के कलेक्शन के आधार पर ग्रिड के कॉलम सेट करता है. अगर दी गई अरे खाली है, तो एक अपवाद देता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
columns | String[] | कॉलम के वैल्यू का कलेक्शन, जिसे फ़ॉर्म देखते समय जवाब देने वाले लोगों को लेबल के तौर पर दिखते हैं |
रिटर्न
CheckboxGridItem
— यह आइटम, चेन में रखने के लिए है
थ्रो
Error
— अगर दिया गया अरे null
है या खाली है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
आइटम का सहायता टेक्स्ट सेट करता है. इसे कभी-कभी ImageItems
, PageBreakItems
, और SectionHeaderItems
जैसे लेआउट आइटम के लिए, जानकारी वाला टेक्स्ट भी कहा जाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
text | String | नया सहायता टेक्स्ट |
रिटर्न
CheckboxGridItem
— यह CheckboxGridItem
, चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
यह सेट करता है कि जवाब देने वाले व्यक्ति को सवाल का जवाब देना चाहिए या नहीं.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
enabled | Boolean | जवाब देने वाले व्यक्ति को सवाल का जवाब देना चाहिए या नहीं |
रिटर्न
CheckboxGridItem
— मौजूदा आइटम (चेनिंग के लिए)
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
वैल्यू के कलेक्शन के आधार पर ग्रिड की पंक्तियां सेट करता है. अगर दी गई अरे खाली है, तो यह अपवाद दिखाता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
rows | String[] | पंक्ति के मानों की श्रेणी, जिसे फ़ॉर्म देखते समय जवाब देने वाले लेबल के रूप में देखते हैं |
रिटर्न
CheckboxGridItem
— यह आइटम, चेन में रखने के लिए है
थ्रो
Error
— अगर दिया गया अरे null
है या खाली है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
आइटम का शीर्षक सेट करता है (SectionHeaderItem
के मामले में, कभी-कभी इसे हेडर टेक्स्ट कहा जाता है).
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
title | String | नया शीर्षक या हेडर टेक्स्ट |
रिटर्न
CheckboxGridItem
— यह CheckboxGridItem
, चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
इस चेकबॉक्स ग्रिड आइटम के लिए, डेटा की पुष्टि सेट करता है. बिना किसी ज़रूरी फ़ंक्शन के, शून्य या पुष्टि करने पर, पहले से की गई कोई भी पुष्टि हट जाएगी.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
validation | CheckboxGridValidation | इस आइटम पर लागू करने के लिए CheckboxGridValidation. |
रिटर्न
CheckboxGridItem
— यह CheckboxGridItem
, चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms