खास जानकारी

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 संसाधन.

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

फ़ॉर्म और क्विज़ मैनेज करते समय, अलग-अलग फ़ील्ड चुनने का तरीका जानें मुश्किल हो सकता है, क्योंकि कई फ़ॉर्म ऑब्जेक्ट को प्रॉपर्टी के अंदर नेस्ट किया जा सकता है कई तरीकों से एक-दूसरे से जुड़ी हुई हैं. यह देखने के लिए कि फ़ॉर्म को विज़ुअल रूप से कैसे दिखाया जाता है तो हमारा सुझाव है कि आप यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, ऐसे फ़ॉर्म होते हैं जो आपका ऐप्लिकेशन जनरेट कर सकता है. इसके बाद, संबंधित 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": "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"
              }
            ]
          }
        }
      }
    }
  ]
}

अगले चरण