खास जानकारी

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

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

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

फ़ॉर्म

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

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

क्विज़

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

ग्रेडिंग

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

सुझाव, राय या शिकायत

क्विज़ में किसी सवाल का जवाब देते समय, असली उपयोगकर्ता को दिया गया जवाब. इसे Feedback संसाधन के तौर पर दिखाया जाता है.

Item

फ़ॉर्म में मौजूद कोई एक एलिमेंट, जिसे 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"
              }
            ]
          }
        }
      }
    }
  ],
  "publishSettings" : {
    "isPublished": true,
    "isAcceptingResponses": true
  }
}

अगले चरण

• Google Workspace API का इस्तेमाल करके डेवलपमेंट करने के बारे में जानने के लिए, Workspace डेवलपर के तौर पर शुरुआत करना लेख पढ़ें. इसमें पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज करने के बारे में भी बताया गया है.
• Forms API का इस्तेमाल करके बुनियादी ऐप्लिकेशन को कॉन्फ़िगर करने और चलाने का तरीका जानने के लिए, क्विकस्टार्ट की खास जानकारी पढ़ें.