खास जानकारी

Google Forms API, RESTful इंटरफ़ेस है. इसकी मदद से, फ़ॉर्म और क्विज़ बनाए और उनमें बदलाव किए जा सकते हैं. साथ ही, फ़ॉर्म के जवाब और क्विज़ के ग्रेड वापस पाए जा सकते हैं. इसके अलावा, क्विज़ की जवाब कुंजियां सेट अप की जा सकती हैं. इनमें अपने-आप सुझाव देने की सुविधा भी होती है. साथ ही, पुश नोटिफ़िकेशन भी पाए जा सकते हैं. इस एपीआई का इस्तेमाल आम तौर पर इन कामों के लिए किया जाता है:

  • फ़ॉर्म या क्विज़ बनाना
  • जवाब देने वाले लोगों की जानकारी पब्लिश और मैनेज करना
  • फ़ॉर्म या क्विज़ अपडेट करना
  • फ़ॉर्म या क्विज़ से जवाब वापस पाना
  • फ़ॉर्म का कॉन्टेंट और मेटाडेटा पढ़ना
  • पुश नोटिफ़िकेशन सेट अप करना और उन्हें पाना
यहां Forms API में इस्तेमाल होने वाले सामान्य शब्दों की सूची दी गई है:
फ़ॉर्म

यह Google Forms का एक ऐसा दस्तावेज़ है जिसे Drive में बनाया और सेव किया जाता है. हर फ़ॉर्म को Form संसाधन के तौर पर दिखाया जाता है. इसका unique formId वैल्यू यूनीक होता है. इसमें अक्षर, संख्याएं, हाइफ़न या अंडरस्कोर शामिल हो सकते हैं. फ़ॉर्म आईडी, Forms के यूआरएल में देखा जा सकता है:

https://docs.google.com/forms/d/FORM_ID/edit

क्विज़

यह Google Forms के दस्तावेज़ का एक खास टाइप है. इसमें जवाब कुंजी के आधार पर, फ़ॉर्म के जवाबों को ग्रेड किया जा सकता है. क्विज़ सिर्फ़ तरीके का इस्तेमाल करके बनाया जा सकता है. इसके लिए, मौजूदा फ़ॉर्म की isQuiz सेटिंग को true पर अपडेट करना होगा.batchUpdate()

ग्रेडिंग
इसमें किसी सवाल के लिए तय किए गए पॉइंट, जवाब कुंजी, और सुझाव शामिल होते हैं. यह तब लागू होता है, जब isQuiz की वैल्यू true होती है. इसे Grading संसाधन के तौर पर दिखाया जाता है.
सुझाव, राय या शिकायत
यह क्विज़ के किसी सवाल का जवाब देने पर, एंड यूज़र को दिया जाने वाला जवाब है, जिसे Feedback संसाधन के तौर पर दिखाया जाता है.
आइटम

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

सवाल

यह फ़ॉर्म का एक सवाल है. इसे Question संसाधन के तौर पर दिखाया जाता है.

सवालों का ग्रुप

यह सवालों का एक ऐसा ग्रुप है जिनके लिए जवाबों का एक ही सेट उपलब्ध होता है. उदाहरण के लिए, 1 से 5 तक रेटिंग की ग्रिड. इसे QuestionGroupItem संसाधन के तौर पर दिखाया जाता है.

सेक्शन

सेक्शन की मदद से, फ़ॉर्म को कई पेजों में बांटा जा सकता है. साथ ही, इसमें शर्त के हिसाब से लॉजिक जोड़ा जा सकता है. जैसे, उपयोगकर्ता के जवाब के आधार पर कुछ सवाल दिखाना. सेक्शन, PageBreakItem संसाधन से जुड़े होते हैं.

जवाब

यह किसी सवाल का एंड यूज़र का जवाब है. इसे Answer संसाधन के तौर पर दिखाया जाता है. इसमें ग्रेड की जानकारी (अगर मौजूद हो), मेटाडेटा, और जवाब का कॉन्टेंट, दोनों शामिल होते हैं.

जवाब

यह एंड यूज़र का फ़ॉर्म सबमिट करना है. इसे FormResponse संसाधन के तौर पर दिखाया जाता है.

घड़ी

यह एक ऐसा ट्रिगर है जो फ़ॉर्म स्कीमा में होने वाले बदलावों (जैसे, सवालों में किए गए बदलाव) या फ़ॉर्म के जवाब सबमिट किए जाने की जानकारी ट्रैक करता है. साथ ही, बदलाव होने पर पुश नोटिफ़िकेशन भेजता है. इसे Watch संसाधन के तौर पर दिखाया जाता है.

फ़ॉर्म का स्ट्रक्चर

फ़ॉर्म और क्विज़ मैनेज करते समय, अलग-अलग फ़ील्ड तय करने का तरीका समझना मुश्किल हो सकता है. ऐसा इसलिए, क्योंकि फ़ॉर्म के कई ऑब्जेक्ट एक-दूसरे में कई तरीकों से नेस्ट किए जा सकते हैं. फ़ॉर्म के विज़ुअल प्रज़ेंटेशन को फ़ील्ड से मैप करने का तरीका जानने के लिए, हमारा सुझाव है कि यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, फ़ॉर्म के कुछ ऐसे उदाहरण बनाएं जिन्हें आपका ऐप्लिकेशन जनरेट कर सकता है. इसके बाद, उससे जुड़ा JSON वापस पाएं forms.get() तरीके का इस्तेमाल करके , ताकि तुलना की जा सके. उदाहरण के लिए, इस क्विज़ का JSON यहां दिया गया है: 

{
  "formId": "FORM_ID",
  "info": {
    "title": "Famous Black Women",
    "description": "Please complete this quiz based off of this week's readings for class.",
    "documentTitle": "Famous Black Women"
  },
  "settings": {
    "quizSettings": {
      "isQuiz": true
    }
  },
  "revisionId": "00000021",
  "responderUri": "https://docs.google.com/forms/d/e/1FAIpQLSd0iBLPh4suZoGW938EU1WIxzObQv_jXto0nT2U8HH2KsI5dg/viewform",
  "items": [
    {
      "itemId": "5d9f9786",
      "imageItem": {
        "image": {
          "contentUri": "DIRECT_URL",
          "properties": {
            "alignment": "LEFT"
          }
        }
      }
    },
    {
      "itemId": "72b30353",
      "title": "Which African American woman authored \"I Know Why the Caged Bird Sings\"?",
      "questionItem": {
        "question": {
          "questionId": "25405d4e",
          "required": true,
          "grading": {
            "pointValue": 2,
            "correctAnswers": {
              "answers": [
                {
                  "value": "Maya Angelou"
                }
              ]
            }
          },
          "choiceQuestion": {
            "type": "RADIO",
            "options": [
              {
                "value": "Maya Angelou"
              },
              {
                "value": "bell hooks"
              },
              {
                "value": "Alice Walker"
              },
              {
                "value": "Roxane Gay"
              }
            ]
          }
        }
      }
    },
    {
      "itemId": "0a4859c8",
      "title": "Who was the first Dominican-American woman elected to state office?",
      "questionItem": {
        "question": {
          "questionId": "37fff47a",
          "grading": {
            "pointValue": 2,
            "correctAnswers": {
              "answers": [
                {
                  "value": "Grace Diaz"
                }
              ]
            }
          },
          "choiceQuestion": {
            "type": "RADIO",
            "options": [
              {
                "value": "Rosa Clemente"
              },
              {
                "value": "Grace Diaz"
              },
              {
                "value": "Juana Matias"
              },
              {
                "value": "Sabrina Matos"
              }
            ]
          }
        }
      }
    }
  ],
  "publishSettings" : {
    "isPublished": true,
    "isAcceptingResponses": true
  }
}

अगले चरण