Class FormResponse

FormResponse

फ़ॉर्म का पूरा जवाब. FormResponse का इस्तेमाल तीन तरीकों से किया जा सकता है: ऐक्सेस करने के लिए प्रोग्राम के हिसाब से, जवाब देने वाले व्यक्ति ने जो जवाब सबमिट किए हैं (getItemResponses() देखें) फ़ॉर्म का जवाब सबमिट करें (withItemResponse(response) और submit() देखें) और उस फ़ॉर्म का यूआरएल जनरेट करने के लिए जो दिए गए फ़ील्ड का इस्तेमाल करके फ़ील्ड को पहले से भरता है जवाब. FormResponse को Form से बनाया या ऐक्सेस किया जा सकता है. 

// Open a form by ID and log the responses to each question.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  var itemResponses = formResponse.getItemResponses();
  for (var j = 0; j < itemResponses.length; j++) {
    var itemResponse = itemResponses[j];
    Logger.log('Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse());
  }
}

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getEditResponseUrl()Stringऐसा यूआरएल जनरेट करता है जिसका इस्तेमाल, पहले से सबमिट किए गए जवाब में बदलाव करने के लिए किया जा सकता है.
getGradableItemResponses()ItemResponse[]फ़ॉर्म के जवाब में शामिल सभी आइटम के जवाबों को उसी क्रम में हासिल करता है जिस क्रम में आइटम दिखते हैं फ़ॉर्म में.
getGradableResponseForItem(item)ItemResponseदिए गए आइटम के लिए फ़ॉर्म में दिए गए जवाब में शामिल आइटम दिखाता है.
getId()Stringफ़ॉर्म में दिए गए जवाब का आईडी लेता है.
getItemResponses()ItemResponse[]फ़ॉर्म के जवाब में शामिल सभी आइटम के जवाबों को उसी क्रम में हासिल करता है जिस क्रम में आइटम दिखते हैं फ़ॉर्म में.
getRespondentEmail()Stringअगर Form.setCollectEmail(collect) सेटिंग चालू है, तो जवाब सबमिट करने वाले व्यक्ति का ईमेल पता भेजा जाता है.
getResponseForItem(item)ItemResponseदिए गए आइटम के लिए इस फ़ॉर्म जवाब में शामिल आइटम जवाब लाता है.
getTimestamp()Dateफ़ॉर्म पर दिए गए जवाब को सबमिट करने पर, उसका टाइमस्टैंप मिलता है.
submit()FormResponseजवाब सबमिट करता है.
toPrefilledUrl()Stringइस फ़ॉर्म के लिए, इस फ़ॉर्म में दिए गए जवाबों के आधार पर, पहले से भरे गए जवाबों का यूआरएल जनरेट करता है फ़ॉर्म प्रतिक्रिया.
withItemGrade(gradedResponse)FormResponseदिए गए आइटम जवाब के ग्रेड को फ़ॉर्म जवाब में जोड़ता है.
withItemResponse(response)FormResponseदिए गए आइटम जवाब को फ़ॉर्म जवाब में जोड़ता है.

विस्तृत दस्तावेज़

getEditResponseUrl()

ऐसा यूआरएल जनरेट करता है जिसका इस्तेमाल, पहले से सबमिट किए गए जवाब में बदलाव करने के लिए किया जा सकता है. अगर 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

getGradableItemResponses()

फ़ॉर्म के जवाब में शामिल सभी आइटम के जवाबों को उसी क्रम में हासिल करता है जिस क्रम में आइटम दिखते हैं फ़ॉर्म में. यह तरीका, getItemResponses() की तरह ही काम करता है. हालांकि, यह ग्रेडिंग की अनुमति देने के लिए काम करता है कोई जवाब मौजूद नहीं है, तब भी यह ItemResponse दिखाता है, अगर संबंधित 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()}`);
  }
}

वापसी का टिकट

ItemResponse[] — फ़ॉर्म में सवाल के हर आइटम के जवाबों की एक कलेक्शन, जिसके लिए जवाब देने वाला व्यक्ति ऐसा करता है स्कोर मिल सकता है.

अनुमति देना

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

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

getGradableResponseForItem(item)

दिए गए आइटम के लिए फ़ॉर्म में दिए गए जवाब में शामिल आइटम दिखाता है. यह तरीका काम करता है यह getResponseForItem(item) की तरह ही है, लेकिन छूटे हुए जवाब को ग्रेड देने के लिए, यह अब भी अगर इससे जुड़े Item को ग्रेड दिया जा सकता है, तो ItemResponse दिखाता है (जैसे कि पॉइंट है वैल्यू), भले ही कोई असल जवाब न हो. हालांकि, अगर 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()}`);
}

पैरामीटर

नामटाइपब्यौरा
itemItem

वापसी का टिकट

ItemResponse — किसी दिए गए आइटम के लिए रिस्पॉन्स या null, अगर कोई मौजूद नहीं है और आइटम को ग्रेड नहीं किया गया है.

getId()

फ़ॉर्म में दिए गए जवाब का आईडी लेता है. अगर फ़ॉर्म का जवाब नहीं मिलता है, तो यह तरीका 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

getItemResponses()

फ़ॉर्म के जवाब में शामिल सभी आइटम के जवाबों को उसी क्रम में हासिल करता है जिस क्रम में आइटम दिखते हैं फ़ॉर्म में. अगर फ़ॉर्म के जवाब में दिए गए TextItem के लिए कोई जवाब शामिल नहीं है, तो DateItem, TimeItem या ParagraphTextItem, ItemResponse उस आइटम के लिए दिए गए जवाब में एक खाली स्ट्रिंग होगी. अगर फ़ॉर्म के जवाब में किसी अन्य आइटम टाइप के लिए रिस्पॉन्स देते हैं, तो यह तरीका उस आइटम को उसके लौटाए गए कलेक्शन से बाहर रखता है. 

// 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()}'`);
  }
}

वापसी का टिकट

ItemResponse[] — फ़ॉर्म में सवाल के हर आइटम के जवाबों की एक कलेक्शन, जिसके लिए जवाब देने वाला व्यक्ति ऐसा करता है ने एक उत्तर दिया है.

अनुमति देना

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

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

getRespondentEmail()

अगर 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

getResponseForItem(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());
}

पैरामीटर

नामटाइपब्यौरा
itemItem

वापसी का टिकट

ItemResponse — किसी दिए गए आइटम के लिए जवाब या अगर मौजूद नहीं है, तो null.

getTimestamp()

फ़ॉर्म पर दिए गए जवाब को सबमिट करने पर, उसका टाइमस्टैंप मिलता है.

उस फ़ॉर्म उत्तर के लिए जिसे स्क्रिप्ट ने बनाया है, लेकिन अभी तक सबमिट नहीं किया है, यह विधि वापस 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();

वापसी का टिकट

FormResponse — नया बनाया गया जवाब, फ़ॉर्म के जवाब स्टोर में सेव किया जाता है.

अनुमति देना

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

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

toPrefilledUrl()

इस फ़ॉर्म के लिए, इस फ़ॉर्म में दिए गए जवाबों के आधार पर, पहले से भरे गए जवाबों का यूआरएल जनरेट करता है फ़ॉर्म प्रतिक्रिया. 

// 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

withItemGrade(gradedResponse)

दिए गए आइटम जवाब के ग्रेड को फ़ॉर्म जवाब में जोड़ता है. यह विधि केवल फ़ॉर्म पर लागू होती है ऐसे जवाब जो पहले ही सबमिट कर दिए गए हैं और उनका असर स्टोर किए गए ग्रेड पर सिर्फ़ तब पड़ता है, जब वे सबमिट किया गया. इस तरीके से सिर्फ़ आइटम के जवाब के ग्रेड को अपडेट किया जाता है; तो इससे आपकी कंपनी की असली जवाब (क्योंकि जवाब पहले ही सबमिट किया जा चुका है). अगर इस तरीके को कॉल किया जाए, तो एक ही आइटम के लिए कई बार, सिर्फ़ आखिरी ग्रेड को सेव रखा जाता है. अगर itemResponse में यह शामिल है कोई ग्रेड नहीं, इस तरीके से आइटम के ग्रेड हटा दिए जाएंगे. 

// Programmatically award partial credit for a given response
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
var formItems = form.getItems();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  for (var j = 0; j < formItems.length; j++) {
    var item = formItems[j];
    var points = item.asMultipleChoiceItem().getPoints();
    var itemResponse = formResponse.getGradableResponseForItem(item);
    Logger.log('Award half credit for answers containing the word "Kennedy"');
    var answer = itemResponse.getResponse();
    if (answer != null && answer.includes('Kennedy')) {
      itemResponse.setScore(points / 2);
      formResponse.withItemGrade(itemResponse);
    }
  }
}
form.submitGrades(formResponses);

पैरामीटर

नामटाइपब्यौरा
gradedResponseItemResponse

वापसी का टिकट

FormResponse — यह FormResponse, चेन बनाने के लिए

अनुमति देना

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

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

withItemResponse(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();

पैरामीटर

नामटाइपब्यौरा
responseItemResponse

वापसी का टिकट

FormResponse — चेन बनाने के लिए, यह FormResponse.

अनुमति देना

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

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