ওভারভিউ

Google Forms API হল একটি RESTful ইন্টারফেস যা আপনাকে ফর্ম এবং কুইজগুলি তৈরি এবং সংশোধন করতে, ফর্মের প্রতিক্রিয়া এবং কুইজ গ্রেডগুলি পুনরুদ্ধার করতে, স্বয়ংক্রিয় প্রতিক্রিয়া সহ কুইজের উত্তর কী সেট আপ করতে এবং পুশ বিজ্ঞপ্তিগুলি পেতে দেয়৷ এই API এর সবচেয়ে সাধারণ ব্যবহারগুলির মধ্যে নিম্নলিখিত কাজগুলি অন্তর্ভুক্ত রয়েছে:

  • একটি ফর্ম বা কুইজ তৈরি করুন
  • প্রকাশ করুন এবং উত্তরদাতাদের পরিচালনা করুন
  • একটি ফর্ম বা কুইজ আপডেট করুন
  • একটি ফর্ম বা কুইজ থেকে প্রতিক্রিয়া পুনরুদ্ধার করুন
  • ফর্ম বিষয়বস্তু এবং মেটাডেটা পড়ুন
  • সেট আপ করুন এবং পুশ বিজ্ঞপ্তি গ্রহণ করুন
নিম্নলিখিতটি ফর্ম API-এ ব্যবহৃত সাধারণ পদগুলির একটি তালিকা:
ফর্ম

একটি Google ফর্ম ডকুমেন্ট, তৈরি এবং ড্রাইভে সংরক্ষিত। প্রতিটি ফর্ম একটি Form রিসোর্স দ্বারা প্রতিনিধিত্ব করা হয় এবং একটি অনন্য formId মান রয়েছে, যার মধ্যে অক্ষর, সংখ্যা, হাইফেন বা আন্ডারস্কোর রয়েছে। আপনি একটি Google ফর্ম URL-এ ফর্ম আইডি খুঁজে পেতে পারেন:

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

কুইজ

একটি নির্দিষ্ট ধরনের Google Forms নথি যা একটি উত্তর কী-এর বিপরীতে ফর্মের প্রতিক্রিয়াগুলির গ্রেডিংয়ের অনুমতি দেয়৷ একটি ক্যুইজ শুধুমাত্র batchUpdate() পদ্ধতি ব্যবহার করে তৈরি করা যেতে পারে একটি বিদ্যমান ফর্মের isQuiz সেটিংসটিকে true আপডেট করতে।

গ্রেডিং
একটি পয়েন্ট মান, উত্তর কী, এবং একটি প্রশ্নের জন্য প্রতিক্রিয়া, যখন isQuiz true হয় তখন প্রয়োগ করা হয়। Grading সম্পদ দ্বারা প্রতিনিধিত্ব.
প্রতিক্রিয়া
Feedback সংস্থান দ্বারা প্রতিনিধিত্ব করা একটি কুইজে একটি প্রশ্নের উত্তর দেওয়ার সময় শেষ ব্যবহারকারীকে দেওয়া একটি প্রতিক্রিয়া।
আইটেম

একটি ফর্মের একটি একক উপাদান, আইটেম সংস্থান দ্বারা প্রতিনিধিত্ব করা হয়৷ Item একটি পুনরাবৃত্তি উপাদান যা একটি বিভাগ, প্রশ্ন গ্রুপ, প্রশ্ন, পাঠ্য, চিত্র, বা ভিডিও থাকতে পারে।

প্রশ্ন

ফর্মে একটি একক প্রশ্ন, Question সংস্থান দ্বারা প্রতিনিধিত্ব করা হয়।

প্রশ্ন গ্রুপ

প্রশ্নগুলির একটি গ্রুপ যা সকলেই সম্ভাব্য উত্তরগুলির একই সেট ভাগ করে (উদাহরণস্বরূপ, 1 থেকে 5 রেটিংগুলির একটি গ্রিড)। QuestionGroupItem রিসোর্স দ্বারা প্রতিনিধিত্ব করা হয়।

ধারা

একটি বিভাগ হল একটি ফর্মকে একাধিক পৃষ্ঠায় বিভক্ত করার এবং শর্তযুক্ত যুক্তি যোগ করার একটি উপায় (যেমন ব্যবহারকারী কীভাবে উত্তর দেয় তার উপর ভিত্তি করে শুধুমাত্র নির্দিষ্ট প্রশ্নগুলি দেখানো)। বিভাগগুলি PageBreakItem সম্পদের সাথে মিলে যায়৷

উত্তর

একটি প্রশ্নের শেষ ব্যবহারকারীর উত্তর, Answer সংস্থান দ্বারা প্রতিনিধিত্ব করা হয়। উভয় গ্রেড তথ্য (যদি উপস্থিত থাকে), মেটাডেটা এবং উত্তরের বিষয়বস্তু অন্তর্ভুক্ত করে।

প্রতিক্রিয়া

শেষ ব্যবহারকারীর একটি ফর্ম জমা দেওয়া, FormResponse সংস্থান দ্বারা প্রতিনিধিত্ব করা৷

ঘড়ি

একটি ট্রিগার যা হয় ফর্ম স্কিমা পরিবর্তনগুলির পরিবর্তনগুলিকে ট্র্যাক করে (যেমন প্রশ্নগুলির সম্পাদনা) বা প্রতিক্রিয়া জমা দেওয়া ফর্ম এবং একটি পরিবর্তন ঘটলে একটি পুশ বিজ্ঞপ্তি পাঠায়৷ Watch রিসোর্স দ্বারা প্রতিনিধিত্ব.

ফর্ম গঠন

ফর্ম এবং ক্যুইজগুলি পরিচালনা করার সময়, বিভিন্ন ক্ষেত্রগুলি কীভাবে নির্দিষ্ট করতে হয় তা বোঝা জটিল হতে পারে, কারণ অনেকগুলি ফর্ম অবজেক্ট একাধিক উপায়ে একে অপরের ভিতরে নেস্ট করা যেতে পারে। একটি ফর্ম ম্যাপের ভিজ্যুয়াল রিপ্রেজেন্টেশন কীভাবে ক্ষেত্রগুলিতে ম্যাপ করে তা দেখতে, আমরা আপনার অ্যাপ্লিকেশন তৈরি করতে পারে এমন ফর্মগুলির কয়েকটি উদাহরণ তৈরি করতে UI ব্যবহার করার পরামর্শ দিই৷ তারপর 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
  }
}

পরবর্তী পদক্ষেপ