खास जानकारी

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

  • फ़ॉर्म या क्विज़ बनाना
  • फ़ॉर्म या क्विज़ को अपडेट करना
  • फ़ॉर्म या क्विज़ से जवाब पाना
  • फ़ॉर्म का कॉन्टेंट और मेटाडेटा पढ़ना
  • पुश नोटिफ़िकेशन सेट अप करना और पाना

Forms API में इस्तेमाल किए गए कुछ सामान्य शब्दों की सूची यहां दी गई है:

फ़ॉर्म

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

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

क्विज़

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

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

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

सवाल

फ़ॉर्म पर एक सवाल, जिसे Question रिसॉर्स से दिखाया गया हो.

सवाल का ग्रुप

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

Section

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

जवाब दें

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

जवाब

असली उपयोगकर्ता का फ़ॉर्म सबमिट करना, जिसे FormResponse रिसॉर्स से दिखाया गया है.

देखें

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

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

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

{
  "formId": "FORM_ID",
  "info": {
    "title": "Famous Black Women",
    "description": "Please complete this quiz based off of this week's readings for class.",
    "documentTitle": "API Example Quiz"
  },
  "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"
              }
            ]
          }
        }
      }
    }
  ]
}

अगले चरण