खास जानकारी

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 संसाधन के तौर पर दिखाया गया है.

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

सवालों का ऐसा ग्रुप जिसमें संभावित जवाबों का एक ही सेट हो (उदाहरण के लिए, एक से पांच तक की रेटिंग का ग्रिड). यह जानकारी 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"
              }
            ]
          }
        }
      }
    }
  ]
}

अगले चरण

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