Class FormApp

Formऐप्लिकेशन

इसकी मदद से, स्क्रिप्ट किसी मौजूदा Form को खोल सकती है या नया Form बना सकती है. 

// Open a form by ID.
const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
const newForm = FormApp.create('Form Name');

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
AlignmentAlignmentइमेज अलाइनमेंट के टाइप की जानकारी.
DestinationTypeDestinationTypeडेस्टिनेशन के टाइप की सूची, जो फ़ॉर्म के जवाबों को सेव कर सकते हैं.
FeedbackTypeFeedbackTypeFeedbacks फ़ॉर्म के टाइप की जानकारी.
ItemTypeItemTypeItems फ़ॉर्म के टाइप की जानकारी.
PageNavigationTypePageNavigationTypeपेजों पर नेविगेट करने के संभावित तरीकों की जानकारी.
RatingIconTypeRatingIconTypeरेटिंग आइकॉन के टाइप की जानकारी RatingIcons

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
create(title)Formनया Form बनाता है और उसे दिखाता है.
createCheckboxGridValidation()CheckboxGridValidationBuilderCheckboxGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, CheckboxGridItem पर पुष्टि करने के लिए किया जा सकता है.
createCheckboxValidation()CheckboxValidationBuilderCheckboxValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, CheckboxItem पर पुष्टि करने के लिए किया जा सकता है.
createFeedback()QuizFeedbackBuilderQuizFeedbackBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, ग्रेड पाने वाले Item पर फ़ीडबैक सेट करने के लिए किया जा सकता है.
createGridValidation()GridValidationBuilderGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, GridItem पर पुष्टि करने के लिए किया जा सकता है.
createParagraphTextValidation()ParagraphTextValidationBuilderParagraphTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, किसी ParagraphTextItem पर पुष्टि करने के लिए किया जा सकता है.
createTextValidation()TextValidationBuilderTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, TextItem पर पुष्टि करने के लिए किया जा सकता है.
getActiveForm()Formवह फ़ॉर्म दिखाता है जिससे स्क्रिप्ट कंटेनर-बाउंड है.
getUi()Uiयह फ़ॉर्म एडिटर के यूज़र-इंटरफ़ेस एनवायरमेंट का एक इंस्टेंस दिखाता है. इसकी मदद से, स्क्रिप्ट में मेन्यू, डायलॉग, और साइडबार जैसी सुविधाएं जोड़ी जा सकती हैं.
openById(id)Formदिए गए आईडी के साथ Form दिखाता है.
openByUrl(url)Formदिए गए यूआरएल के साथ Form दिखाता है.

ज़्यादा जानकारी वाला दस्तावेज़

create(title)

नया Form बनाता है और उसे दिखाता है. अगर दिया गया टाइटल null या खाली है, तो यह एक अपवाद दिखाता है. 

// Create and open a form.
const form = FormApp.create('Form Name');

पैरामीटर

नामटाइपब्यौरा
titleStringनए फ़ॉर्म का नाम

वापसी का टिकट

Form — नया फ़ॉर्म

थ्रो

Error — अगर दिया गया टाइटल null है या खाली है

अनुमति देना

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

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

createCheckboxGridValidation()

CheckboxGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, CheckboxGridItem पर पुष्टि करने के लिए किया जा सकता है.

वापसी का टिकट

CheckboxGridValidationBuilder

createCheckboxValidation()

CheckboxValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, CheckboxItem पर पुष्टि करने के लिए किया जा सकता है.

वापसी का टिकट

CheckboxValidationBuilder

createFeedback()

QuizFeedbackBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, ग्रेड पाने वाले Item पर फ़ीडबैक सेट करने के लिए किया जा सकता है.

वापसी का टिकट

QuizFeedbackBuilder

createGridValidation()

GridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, GridItem पर पुष्टि करने के लिए किया जा सकता है.

वापसी का टिकट

GridValidationBuilder

createParagraphTextValidation()

ParagraphTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, किसी ParagraphTextItem पर पुष्टि करने के लिए किया जा सकता है.

वापसी का टिकट

ParagraphTextValidationBuilder

createTextValidation()

TextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, TextItem पर पुष्टि करने के लिए किया जा सकता है.

वापसी का टिकट

TextValidationBuilder

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');

पैरामीटर

नामटाइपब्यौरा
idStringजिस फ़ॉर्म को खोलना है उसका आईडी

वापसी का टिकट

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',
);

पैरामीटर

नामटाइपब्यौरा
urlStringखोले जाने वाले फ़ॉर्म का यूआरएल

वापसी का टिकट

Form — दिए गए यूआरएल वाला फ़ॉर्म

थ्रो

Error — अगर दिया गया यूआरएल अमान्य है या उपयोगकर्ता के पास ज़रूरी अनुमतियां नहीं हैं

अनुमति देना

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

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