फ़ॉर्म का पूरा जवाब. Form
का इस्तेमाल तीन तरीकों से किया जा सकता है: किसी व्यक्ति के सबमिट किए गए जवाबों को ऐक्सेस करने के लिए (get
देखें), प्रोग्राम के हिसाब से फ़ॉर्म में जवाब सबमिट करने के लिए (with
और submit()
देखें), और फ़ॉर्म के लिए ऐसा यूआरएल जनरेट करने के लिए जो दिए गए जवाबों का इस्तेमाल करके फ़ील्ड को पहले से भर देता है. Form
को Form
से बनाया या ऐक्सेस किया जा सकता है.
// Open a form by ID and log the responses to each question. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const formResponses = form.getResponses(); for (let i = 0; i < formResponses.length; i++) { const formResponse = formResponses[i]; const itemResponses = formResponse.getItemResponses(); for (let j = 0; j < itemResponses.length; j++) { const itemResponse = itemResponses[j]; Logger.log( 'Response #%s to the question "%s" was "%s"', (i + 1).toString(), itemResponse.getItem().getTitle(), itemResponse.getResponse(), ); } }
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
get | String | ऐसा यूआरएल जनरेट करता है जिसका इस्तेमाल, पहले से सबमिट किए गए जवाब में बदलाव करने के लिए किया जा सकता है. |
get | Item | फ़ॉर्म के जवाब में मौजूद सभी आइटम के जवाब, उसी क्रम में दिखाता है जिस क्रम में आइटम फ़ॉर्म में दिखते हैं. |
get | Item | किसी आइटम के लिए, फ़ॉर्म के रिस्पॉन्स में मौजूद आइटम का रिस्पॉन्स पाता है. |
get | String | फ़ॉर्म के रिस्पॉन्स का आईडी पाता है. |
get | Item | फ़ॉर्म के जवाब में मौजूद सभी आइटम के जवाब, उसी क्रम में दिखाता है जिस क्रम में आइटम फ़ॉर्म में दिखते हैं. |
get | String | अगर Form.setCollectEmail(collect) सेटिंग चालू है, तो जवाब सबमिट करने वाले व्यक्ति का ईमेल पता मिलता है. |
get | Item | किसी आइटम के लिए, इस फ़ॉर्म के रिस्पॉन्स में मौजूद आइटम का रिस्पॉन्स पाता है. |
get | Date | फ़ॉर्म के जवाब को सबमिट करने का टाइमस्टैंप दिखाता है. |
submit() | Form | जवाब सबमिट करता है. |
to | String | इस फ़ॉर्म के जवाबों के आधार पर, उस फ़ॉर्म का यूआरएल जनरेट करता है जिसमें जवाब पहले से भरे होते हैं. |
with | Form | फ़ॉर्म के जवाब में, दिए गए आइटम के जवाब के ग्रेड जोड़ता है. |
with | Form | फ़ॉर्म के जवाब में, दिए गए आइटम का जवाब जोड़ता है. |
ज़्यादा जानकारी वाला दस्तावेज़
get Edit Response Url()
ऐसा यूआरएल जनरेट करता है जिसका इस्तेमाल, पहले से सबमिट किए गए जवाब में बदलाव करने के लिए किया जा सकता है. अगर Form.setAllowResponseEdits(enabled)
सेटिंग बंद है, तो लिंक से एक पेज खुलता है. इस पेज पर बताया जाता है कि फ़ॉर्म के जवाबों में बदलाव करने की सुविधा बंद है. लिंक पर जाने वाला कोई भी व्यक्ति, जवाब में बदलाव कर सकता है. हालांकि, अगर
सेटिंग चालू है, तो उसे फ़ॉर्म का ऐक्सेस देने वाले खाते की ज़रूरत होगी. अगर Form.setRequireLogin(requireLogin)Form.setCollectEmail(collect)
सेटिंग चालू है, तो फ़ॉर्म में जवाब देने वाले व्यक्ति के ईमेल पते के बजाय, उस व्यक्ति का ईमेल पता रिकॉर्ड किया जाता है जिसने जवाब में बदलाव किया है.
अगर स्क्रिप्ट ने फ़ॉर्म का जवाब जनरेट किया है, लेकिन उसे अब तक सबमिट नहीं किया है, तो यह तरीका null
दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets the first form response. const formResponse = form.getResponses()[0]; // Gets the edit URL for the first form response and logs it to the console. const editUrl = formResponse.getEditResponseUrl(); console.log(editUrl);
वापसी का टिकट
String
— सबमिट किए गए जवाब में बदलाव करने के लिए यूआरएल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Gradable Item Responses()
फ़ॉर्म के जवाब में मौजूद सभी आइटम के जवाब, उसी क्रम में दिखाता है जिस क्रम में आइटम फ़ॉर्म में दिखते हैं. यह तरीका get
की तरह ही काम करता है. हालांकि, अगर किसी सवाल का जवाब नहीं दिया गया है, तो भी यह Item
दिखाता है. ऐसा तब होता है, जब उस सवाल के लिए Item
को ग्रेड दिया जा सकता है. इसका मतलब है कि उस सवाल के लिए पॉइंट की वैल्यू दी गई है. भले ही, उस सवाल का कोई जवाब न दिया गया हो. हालांकि, अगर Item
को ग्रेड नहीं दिया जा सकता, तो यह तरीका उस आइटम को रिटर्न किए गए कलेक्शन से बाहर रखता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets an array of the form's responses. const formResponses = form.getResponses(); // Gets the item responses contained in each form response. for (const formResponse of formResponses) { const gradableItemsResponses = formResponse.getGradableItemResponses(); // Logs the title and score for each item response to the console. for (const gradableItemsResponse of gradableItemsResponses) { console.log(`${gradableItemsResponse.getItem().getTitle()} score ${gradableItemsResponse.getScore()}`); } }
वापसी का टिकट
Item
— फ़ॉर्म में मौजूद हर सवाल के जवाबों का कलेक्शन, जिसके लिए जवाब देने वाले व्यक्ति को स्कोर मिल सकता है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Gradable Response For Item(item)
किसी आइटम के लिए, फ़ॉर्म के रिस्पॉन्स में मौजूद आइटम का रिस्पॉन्स पाता है. यह तरीका get
की तरह ही काम करता है. हालांकि, अगर किसी सवाल का जवाब नहीं दिया गया है, तो भी Item
दिखाया जाता है. ऐसा तब किया जाता है, जब उस सवाल से जुड़े Item
को ग्रेड दिया जा सकता हो. इसका मतलब है कि उस सवाल के लिए पॉइंट की वैल्यू दी गई हो. हालांकि, अगर Item
को ग्रेड नहीं दिया जा सकता, तो यह तरीका null
दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets an array of the form's responses. const formResponses = form.getResponses(); // Gets the item responses contained in a form response. for (const formResponse of formResponses) { const formItemResponses = formResponse.getGradableItemResponses(); // Logs the title and score for responses to the first item of the form. const itemResponse = formResponse.getGradableResponseForItem( formItemResponses[0].getItem(), ); console.log( `${itemResponse.getItem().getTitle()} score ${itemResponse.getScore()}`, ); }
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
item | Item |
वापसी का टिकट
Item
— किसी आइटम के लिए जवाब या null
, अगर कोई जवाब मौजूद नहीं है और आइटम को ग्रेड नहीं दिया गया है.
get Id()
फ़ॉर्म के रिस्पॉन्स का आईडी पाता है. अगर फ़ॉर्म का जवाब सबमिट नहीं किया गया है, तो यह तरीका null
दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets an array of the form's responses. const formResponses = form.getResponses(); // Loops through the form responses and logs the ID for each form response to // the console. for (const formResponse of formResponses) { console.log(`Response ID: ${formResponse.getId()}`); }
वापसी का टिकट
String
— फ़ॉर्म के जवाब का आईडी. अगर फ़ॉर्म का जवाब सबमिट नहीं किया गया है, तो null
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Item Responses()
फ़ॉर्म के जवाब में मौजूद सभी आइटम के जवाब, उसी क्रम में दिखाता है जिस क्रम में आइटम फ़ॉर्म में दिखते हैं. अगर फ़ॉर्म के जवाब में किसी दिए गए Text
,
Date
, Time
या Paragraph
के लिए कोई जवाब नहीं है, तो उस आइटम के लिए दिखाए गए Item
के जवाब के तौर पर खाली स्ट्रिंग दिखेगी. अगर फ़ॉर्म के रिस्पॉन्स में किसी अन्य आइटम टाइप के लिए रिस्पॉन्स शामिल नहीं है, तो यह तरीका उस आइटम को रिटर्न किए गए कलेक्शन से बाहर रखता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets the responses to the form. const formResponses = form.getResponses(); // Iterates over the responses. for (const formResponse of formResponses) { // Gets the item responses from each form response. const itemResponses = formResponse.getItemResponses(); // Iterates over the item responses. for (const itemResponse of itemResponses) { // Logs the items' questions and responses to the console. console.log( `Response to the question '${itemResponse.getItem().getTitle()}' was '${itemResponse.getResponse()}'`); } }
वापसी का टिकट
Item
— फ़ॉर्म में मौजूद हर सवाल के जवाबों का कलेक्शन, जिसके लिए जवाब देने वाले व्यक्ति ने जवाब दिया है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Respondent Email()
अगर Form.setCollectEmail(collect)
सेटिंग चालू है, तो जवाब सबमिट करने वाले व्यक्ति का ईमेल पता मिलता है.
अगर स्क्रिप्ट ने फ़ॉर्म का जवाब जनरेट किया है, लेकिन उसे अब तक सबमिट नहीं किया है, तो यह तरीका null
दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets an array of the form's responses. const formResponses = form.getResponses(); // Loops through the responses and logs each respondent's email to the console. // To collect respondent emails, ensure that Form.setCollectEmail(collect) is // set to true. for (const formResponse of formResponses) { console.log(`Respondent Email: ${formResponse.getRespondentEmail()}`); }
वापसी का टिकट
String
— अगर यह जवाब सबमिट करने वाले व्यक्ति का ईमेल पता उपलब्ध है, तो वह पता. अगर स्क्रिप्ट ने यह जवाब बनाया है, लेकिन उसे अभी तक सबमिट नहीं किया है, तो null
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Response For Item(item)
किसी आइटम के लिए, इस फ़ॉर्म के रिस्पॉन्स में मौजूद आइटम का रिस्पॉन्स पाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets the first item on the form. const item = form.getItems()[0]; // Gets an array of the form's responses. const formResponses = form.getResponses(); // Loops through the responses and logs each response to the first item to the // console. for (const formResponse of formResponses) { const itemResponse = formResponse.getResponseForItem(item); console.log(itemResponse.getResponse()); }
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
item | Item |
वापसी का टिकट
Item
— किसी आइटम के लिए रिस्पॉन्स या कोई रिस्पॉन्स न होने पर null
.
get Timestamp()
फ़ॉर्म के जवाब को सबमिट करने का टाइमस्टैंप दिखाता है.
अगर स्क्रिप्ट ने फ़ॉर्म का जवाब जनरेट किया है, लेकिन उसे अब तक सबमिट नहीं किया है, तो यह तरीका null
दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets an array of the form's responses. const formResponses = form.getResponses(); // Loops through the responses and logs the timestamp of each response to the // console. for (const formResponse of formResponses) { console.log(`Timestamp: ${formResponse.getTimestamp()}`); }
वापसी का टिकट
Date
— वह टाइमस्टैंप जब यह जवाब सबमिट किया गया था या null
, अगर स्क्रिप्ट ने यह जवाब बनाया है, लेकिन अब तक सबमिट नहीं किया है.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
submit()
जवाब सबमिट करता है. अगर जवाब पहले ही सबमिट कर दिया गया है, तो स्क्रिप्टिंग एक्सेप्शन दिखाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Creates an empty response for the form. const formResponse = form.createResponse(); // Submits an empty response. formResponse.submit();
वापसी का टिकट
Form
— फ़ॉर्म के रिस्पॉन्स स्टोर में सेव किया गया नया जवाब.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
to Prefilled Url()
इस फ़ॉर्म के जवाबों के आधार पर, उस फ़ॉर्म का यूआरएल जनरेट करता है जिसमें जवाब पहले से भरे होते हैं.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Gets the first form response. const formResponse = form.getResponses()[0]; // Generates and logs the URL of a pre-filled form response based on the answers // of the first form response. const prefilledUrl = formResponse.toPrefilledUrl(); console.log(prefilledUrl);
वापसी का टिकट
String
— पहले से भरे हुए जवाबों वाले फ़ॉर्म का यूआरएल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
with Item Grade(gradedResponse)
फ़ॉर्म के जवाब में, दिए गए आइटम के जवाब के ग्रेड जोड़ता है. यह तरीका सिर्फ़ उन फ़ॉर्म के जवाबों पर लागू होता है जिन्हें पहले ही सबमिट कर दिया गया है. साथ ही, सबमिट किए जाने के बाद ही सेव किए गए ग्रेड पर इसका असर पड़ता है. इस तरीके से भी, आइटम के जवाब के ग्रेड ही अपडेट होते हैं. इससे, जवाब पर कोई असर नहीं पड़ता, क्योंकि जवाब पहले ही सबमिट कर दिया गया है. अगर एक ही आइटम के लिए इस तरीके को कई बार कॉल किया जाता है, तो सिर्फ़ आखिरी ग्रेड ही सेव किया जाता है. अगर ItemResponse में कोई ग्रेड नहीं है, तो इस तरीके से आइटम के लिए ग्रेड हटा दिए जाएंगे.
// Programmatically award partial credit for a given response const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const formResponses = form.getResponses(); const formItems = form.getItems(); for (const formResponse of formResponses) { for (const item of formItems) { const points = item.asMultipleChoiceItem().getPoints(); const itemResponse = formResponse.getGradableResponseForItem(item); Logger.log('Award half credit for answers containing the word "Kennedy"'); const answer = itemResponse.getResponse(); if (answer?.includes('Kennedy')) { itemResponse.setScore(points / 2); formResponse.withItemGrade(itemResponse); } } } form.submitGrades(formResponses);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
graded | Item |
वापसी का टिकट
Form
— चेन बनाने के लिए यह Form
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
with Item Response(response)
फ़ॉर्म के जवाब में, दिए गए आइटम का जवाब जोड़ता है. यह तरीका सिर्फ़ उन फ़ॉर्म के जवाबों पर लागू होता है जिन्हें स्क्रिप्ट ने बनाया है, लेकिन अभी तक सबमिट नहीं किया है. इसका असर सेव किए गए जवाबों पर नहीं पड़ता. अगर एक ही आइटम के लिए इस तरीके को कई बार कॉल किया जाता है, तो आइटम का सिर्फ़ आखिरी जवाब ही सेव किया जाता है.
// Opens the Forms file by its ID. // If you created your script from within a Google Forms file, you can // use FormApp.getActiveForm() instead. // TODO(developer): Replace the ID with your own. const form = FormApp.openById('abc123456'); // Creates a response for the form. const formResponse = form.createResponse(); // Appends a checkbox item to the form. const item = form.addCheckboxItem(); // Sets the title of the item to 'Which items are ice cream flavors?' item.setTitle('Which items are ice cream flavors?'); // Sets choices for the item. item.setChoices([ item.createChoice('Vanilla'), item.createChoice('Strawberry'), item.createChoice('Brick'), ]); // Creates a response for the item. const response = item.createResponse(['Vanilla', 'Strawberry']); // Adds the item response to the form response. formResponse.withItemResponse(response); // Submits the form response. formResponse.submit();
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
response | Item |
वापसी का टिकट
Form
— चेन बनाने के लिए यह Form
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms