Class FormApp

FormApp

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

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

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

प्रॉपर्टी

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
create(title)Formनया Form बनाता है और दिखाता है.
createCheckboxGridValidation()CheckboxGridValidationBuilderCheckboxGrid बढ़ियाBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxGridItem पर पुष्टि करने के लिए किया जा सकता है.
createCheckboxValidation()CheckboxValidationBuilderCheckboxDescriptionBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल CheckboxItem पर पुष्टि करने के लिए किया जा सकता है.
createFeedback()QuizFeedbackBuilderक्विज़ फ़ीडबैक बिल्डर का इंस्टेंस दिखाता है, जिसका इस्तेमाल ग्रेड देने लायक Item पर सुझाव सेट करने के लिए किया जा सकता है.
createGridValidation()GridValidationBuilderयह GridValidBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल GridItem पर पुष्टि करने के लिए किया जा सकता है.
createParagraphTextValidation()ParagraphTextValidationBuilderयह ParagraphText VerificationBuilder का इंस्टेंस दिखाता है, जिसका इस्तेमाल ParagraphTextItem पर पुष्टि करने के लिए किया जा सकता है.
createTextValidation()TextValidationBuilderText 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ब्यौरा
titleStringनए फ़ॉर्म का नाम

रिटर्न

Form — नया फ़ॉर्म

थ्रो

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

अनुमति देना

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

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

createCheckboxGridValidation()

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

रिटर्न

CheckboxGridValidationBuilder


createCheckboxValidation()

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

रिटर्न

CheckboxValidationBuilder


createFeedback()

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

रिटर्न

QuizFeedbackBuilder


createGridValidation()

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

रिटर्न

GridValidationBuilder


createParagraphTextValidation()

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

रिटर्न

ParagraphTextValidationBuilder


createTextValidation()

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

रिटर्न

TextValidationBuilder


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ब्यौरा
idStringखुलने वाले फ़ॉर्म का आईडी

रिटर्न

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ब्यौरा
urlStringफ़ॉर्म का यूआरएल, जिसे आपको खोलना है

रिटर्न

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

थ्रो

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

अनुमति देना

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

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