Class FormApp

FormApp

इस स्कोप की मदद से, स्क्रिप्ट को मौजूदा 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 बनाता है और उसे दिखाता है.
create(title, isPublished)Formयह फ़ंक्शन, पब्लिश करने की अनुरोध की गई स्थिति में एक नया Form बनाता है और उसे दिखाता है.
createCheckboxGridValidation()CheckboxGridValidationBuilderयह CheckboxGridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल CheckboxGridItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
createCheckboxValidation()CheckboxValidationBuilderयह CheckboxValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल CheckboxItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
createFeedback()QuizFeedbackBuilderयह QuizFeedbackBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, ग्रेड किए जा सकने वाले Item पर फ़ीडबैक सेट करने के लिए किया जा सकता है.
createGridValidation()GridValidationBuilderयह GridValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल GridItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
createParagraphTextValidation()ParagraphTextValidationBuilderयह ParagraphTextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल ParagraphTextItem पर पुष्टि करने की सुविधा सेट करने के लिए किया जा सकता है.
createTextValidation()TextValidationBuilderयह TextValidationBuilder का एक इंस्टेंस दिखाता है. इसका इस्तेमाल, 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

create(title, isPublished)

यह फ़ंक्शन, पब्लिश करने की अनुरोध की गई स्थिति में एक नया Form बनाता है और उसे दिखाता है. अगर दिया गया टाइटल null है या खाली है, तो यह फ़ंक्शन एक अपवाद दिखाता है.

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

पैरामीटर

नामटाइपब्यौरा
titleStringनए फ़ॉर्म का नाम.
isPublishedBooleanफ़ॉर्म को पब्लिश किया जाना चाहिए या नहीं.

वापसी का टिकट

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