इस स्कोप की मदद से, स्क्रिप्ट को मौजूदा Form खोलने या नया Form बनाने की अनुमति मिलती है.
// Open a form by ID. const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. const newForm = FormApp.create('Form Name');
प्रॉपर्टी
| प्रॉपर्टी | टाइप | ब्यौरा |
|---|---|---|
Alignment | Alignment | इमेज अलाइनमेंट के टाइप की गिनती. |
Destination | Destination | यह उन डेस्टिनेशन के टाइप की गिनती करता है जहां फ़ॉर्म के जवाब सेव किए जा सकते हैं. |
Feedback | Feedback | Feedbacks फ़ॉर्म के टाइप की गिनती. |
Item | Item | Items फ़ॉर्म के टाइप की गिनती. |
Page | Page | पेजों पर नेविगेट करने के संभावित तरीकों की गिनती. |
Rating | Rating | रेटिंग आइकॉन टाइप की गिनती Rating |
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
create(title) | Form | यह एक नया Form बनाता है और उसे दिखाता है. |
create(title, isPublished) | Form | यह फ़ंक्शन, पब्लिश करने की अनुरोध की गई स्थिति में एक नया Form बनाता है और उसे दिखाता है. |
create | Checkbox | यह CheckboxGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल Checkbox पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है. |
create | Checkbox | यह CheckboxValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल Checkbox पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है. |
create | Quiz | यह QuizFeedbackBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, ग्रेड किए जा सकने वाले Item पर फ़ीडबैक सेट करने के लिए किया जा सकता है. |
create | Grid | यह GridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल Grid पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है. |
create | Paragraph | यह ParagraphTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल Paragraph पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है. |
create | Text | यह TextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, Text पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है. |
get | Form | उस फ़ॉर्म को दिखाता है जिससे स्क्रिप्ट कंटेनर से बंधी होती है. |
get | Ui | यह फ़ॉर्म एडिटर के यूज़र-इंटरफ़ेस एनवायरमेंट का एक इंस्टेंस दिखाता है. इससे स्क्रिप्ट को मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ने की अनुमति मिलती है. |
open | Form | यह फ़ंक्शन, दिए गए आईडी के हिसाब से Form दिखाता है. |
open | Form | यह फ़ंक्शन, दिए गए यूआरएल के हिसाब से Form दिखाता है. |
ज़्यादा जानकारी वाला दस्तावेज़
create(title)
यह एक नया Form बनाता है और उसे दिखाता है. अगर दिया गया टाइटल null
या खाली है, तो यह फ़ंक्शन एक अपवाद दिखाता है.
// Create and open a form. const form = FormApp.create('Form Name');
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
title | String | नए फ़ॉर्म का नाम. |
वापसी का टिकट
Form — नया फ़ॉर्म.
थ्रॉ
Error — अगर दिया गया टाइटल null है या खाली है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/forms
create(title, isPublished)
यह फ़ंक्शन, पब्लिश करने की अनुरोध की गई स्थिति में एक नया Form बनाता है और उसे दिखाता है. अगर दिया गया टाइटल null है या खाली है, तो यह फ़ंक्शन एक अपवाद दिखाता है.
// Create, publish and open a form. const form = FormApp.create('Form Name', true);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
title | String | नए फ़ॉर्म का नाम. |
is | Boolean | फ़ॉर्म को पब्लिश किया जाना चाहिए या नहीं. |
वापसी का टिकट
Form — नया फ़ॉर्म.
थ्रॉ
Error — अगर दिया गया टाइटल null है या खाली है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
यह CheckboxGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल CheckboxGridItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
वापसी का टिकट
createCheckboxValidation()
यह CheckboxValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल CheckboxItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
वापसी का टिकट
createFeedback()
यह QuizFeedbackBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, ग्रेड किए जा सकने वाले Item पर फ़ीडबैक सेट करने के लिए किया जा सकता है.
वापसी का टिकट
createGridValidation()
यह GridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल GridItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
वापसी का टिकट
createParagraphTextValidation()
यह ParagraphTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल ParagraphTextItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
वापसी का टिकट
createTextValidation()
यह TextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, TextItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
वापसी का टिकट
getActiveForm()
उस फ़ॉर्म को दिखाता है जिससे स्क्रिप्ट कंटेनर से बंधी होती है. जिन फ़ॉर्म के साथ स्क्रिप्ट कंटेनर-बाउंड नहीं है उनसे इंटरैक्ट करने के लिए, openById(id) या openByUrl(url) का इस्तेमाल करें.
// Get the form to which this script is bound. const 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. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
id | String | खोलने के लिए फ़ॉर्म का आईडी |
वापसी का टिकट
Form — दिए गए आईडी वाला फ़ॉर्म
थ्रॉ
Error — अगर दिया गया आईडी अमान्य है या उपयोगकर्ता के पास ज़रूरी अनुमतियां नहीं हैं
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
यह फ़ंक्शन, दिए गए यूआरएल के हिसाब से Form दिखाता है. अगर यूआरएल अमान्य है या उपयोगकर्ता के पास फ़ॉर्म खोलने की अनुमति नहीं है, तो यह फ़ंक्शन एक अपवाद दिखाता है.
// Open a form by URL. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit', );
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
url | String | खोलने के लिए फ़ॉर्म का यूआरएल |
वापसी का टिकट
Form — दिए गए यूआरएल वाला फ़ॉर्म
थ्रॉ
Error — अगर दिया गया यूआरएल अमान्य है या उपयोगकर्ता के पास ज़रूरी अनुमतियां नहीं हैं
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/forms