स्क्रिप्ट को मौजूदा Form
खोलने या नई बनाने की अनुमति देता है.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
प्रॉपर्टी
प्रॉपर्टी | Type | ब्यौरा |
---|---|---|
Alignment | Alignment | इमेज अलाइनमेंट के टाइप की गिनती. |
DestinationType | DestinationType | उन डेस्टिनेशन के टाइप की गिनती जो फ़ॉर्म के जवाबों को सेव कर सकते हैं. |
FeedbackType | FeedbackType | Feedbacks फ़ॉर्म के टाइप की सूची. |
ItemType | ItemType | Items फ़ॉर्म के टाइप की सूची. |
PageNavigationType | PageNavigationType | पेजों पर नेविगेट करने के संभावित व्यवहार की सूची. |
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
create(title) | Form | नया Form बनाता है और दिखाता है. |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | CheckboxGrid बढ़ियाBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxGridItem पर पुष्टि करने के लिए किया जा सकता है. |
createCheckboxValidation() | CheckboxValidationBuilder | CheckboxDescriptionBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxItem पर पुष्टि करने के लिए किया जा सकता है. |
createFeedback() | QuizFeedbackBuilder | क्विज़ फ़ीडबैक बिल्डर का इंस्टेंस दिखाता है, जिसका इस्तेमाल ग्रेड देने लायक
Item पर सुझाव सेट करने के लिए किया जा सकता है. |
createGridValidation() | GridValidationBuilder | यह GridValidBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल GridItem पर पुष्टि करने के लिए किया जा सकता है. |
createParagraphTextValidation() | ParagraphTextValidationBuilder | यह ParagraphText VerificationBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल ParagraphTextItem पर पुष्टि करने के लिए किया जा सकता है. |
createTextValidation() | TextValidationBuilder | Text VerificationBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल TextItem पर पुष्टि करने के लिए किया जा सकता है. |
getActiveForm() | Form | वह फ़ॉर्म लौटाता है जिसमें स्क्रिप्ट कंटेनर-बाउंड है. |
getUi() | Ui | यह फ़ंक्शन, फ़ॉर्म एडिटर के यूज़र इंटरफ़ेस एनवायरमेंट का इंस्टेंस दिखाता है. इससे स्क्रिप्ट को मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ने की अनुमति मिलती है. |
openById(id) | Form | बताए गए आईडी के साथ Form देता है. |
openByUrl(url) | Form | बताए गए यूआरएल के साथ Form देता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
create(title)
नया Form
बनाता है और दिखाता है. अगर दिया गया टाइटल null
या खाली है, तो अपवाद देता है.
// Create and open a form. var form = FormApp.create('Form Name');
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
title | String | नए फ़ॉर्म का नाम |
रिटर्न
Form
— नया फ़ॉर्म
थ्रो
Error
— अगर दिया गया टाइटल null
है या खाली है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
CheckboxGrid बढ़ियाBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxGridItem
पर पुष्टि करने के लिए किया जा सकता है.
रिटर्न
createCheckboxValidation()
CheckboxDescriptionBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxItem
पर पुष्टि करने के लिए किया जा सकता है.
रिटर्न
createFeedback()
क्विज़ फ़ीडबैक बिल्डर का इंस्टेंस दिखाता है, जिसका इस्तेमाल ग्रेड देने लायक
Item
पर सुझाव सेट करने के लिए किया जा सकता है.
रिटर्न
createGridValidation()
यह GridValidBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल GridItem
पर पुष्टि करने के लिए किया जा सकता है.
रिटर्न
createParagraphTextValidation()
यह ParagraphText VerificationBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल ParagraphTextItem
पर पुष्टि करने के लिए किया जा सकता है.
रिटर्न
createTextValidation()
Text VerificationBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल TextItem
पर पुष्टि करने के लिए किया जा सकता है.
रिटर्न
getActiveForm()
वह फ़ॉर्म लौटाता है जिसमें स्क्रिप्ट कंटेनर-बाउंड है. जिन फ़ॉर्म में स्क्रिप्ट कंटेनर के अंदर नहीं है उनके साथ इंटरैक्ट करने के लिए, openById(id)
या openByUrl(url)
का इस्तेमाल करें.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
रिटर्न
Form
— वह फ़ॉर्म जिस पर स्क्रिप्ट लागू होती है या अगर स्क्रिप्ट किसी फ़ॉर्म से जुड़ी हुई नहीं है, तो null
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
यह फ़ंक्शन, फ़ॉर्म एडिटर के यूज़र इंटरफ़ेस एनवायरमेंट का इंस्टेंस दिखाता है. इससे स्क्रिप्ट को मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ने की अनुमति मिलती है. स्क्रिप्ट सिर्फ़ ओपन फ़ॉर्म एडिटर के मौजूदा इंस्टेंस के लिए यूज़र इंटरफ़ेस (यूआई) के साथ इंटरैक्ट कर सकती है (जवाब देने वाले व्यक्ति को दिखने वाला व्यू नहीं). साथ ही, वह सिर्फ़ तब इंटरैक्ट कर सकती है, जब स्क्रिप्ट, फ़ॉर्म तक बाउंड हो. ज़्यादा जानकारी के लिए, मेन्यू और डायलॉग और साइडबार की गाइड देखें.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
रिटर्न
Ui
— इस फ़ॉर्म के यूज़र इंटरफ़ेस एनवायरमेंट का इंस्टेंस
openById(id)
बताए गए आईडी के साथ Form
देता है. अगर आईडी अमान्य है या
उपयोगकर्ता को फ़ॉर्म खोलने की अनुमति नहीं है, तो यह एक अपवाद है.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
id | String | खुलने वाले फ़ॉर्म का आईडी |
रिटर्न
Form
— दिए गए आईडी वाला फ़ॉर्म
थ्रो
Error
— अगर दिया गया आईडी अमान्य है या उपयोगकर्ता के पास ज़रूरी
अनुमतियां न हों
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
बताए गए यूआरएल के साथ Form
देता है. अगर यूआरएल अमान्य है या
उपयोगकर्ता को फ़ॉर्म खोलने की अनुमति नहीं है, तो अपवाद देता है.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
url | String | फ़ॉर्म का यूआरएल, जिसे आपको खोलना है |
रिटर्न
Form
— दिए गए यूआरएल वाला फ़ॉर्म
थ्रो
Error
— अगर दिया गया यूआरएल अमान्य है या उपयोगकर्ता के पास ज़रूरी
अनुमतियां न हों
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms