ওভারভিউ

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

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

ফর্মস এপিআই-তে ব্যবহৃত সাধারণ শব্দগুলির একটি তালিকা নিচে দেওয়া হল:

ফর্ম

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

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

কুইজ

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

গ্রেডিং

একটি প্রশ্নের জন্য একটি পয়েন্ট মান, উত্তর কী এবং প্রতিক্রিয়া, যখন isQuiz true হয় তখন প্রয়োগ করা হয়। Grading রিসোর্স দ্বারা প্রতিনিধিত্ব করা হয়।

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

একটি কুইজের প্রশ্নের উত্তর দেওয়ার সময় শেষ ব্যবহারকারীকে দেওয়া একটি প্রতিক্রিয়া, যা Feedback সংস্থান দ্বারা উপস্থাপিত হয়।

আইটেম

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

প্রশ্ন

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

প্রশ্ন গ্রুপ

প্রশ্নের একটি গ্রুপ যার সকলের সম্ভাব্য উত্তরের সেট একই রকম (উদাহরণস্বরূপ, ১ থেকে ৫ পর্যন্ত রেটিং এর একটি গ্রিড)। 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
  }
}

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

• Google Workspace API ব্যবহার করে ডেভেলপমেন্ট সম্পর্কে জানতে, যার মধ্যে প্রমাণীকরণ এবং অনুমোদন পরিচালনা করা অন্তর্ভুক্ত, Get started as a Workspace ডেভেলপার দেখুন।
• একটি মৌলিক ফর্মস এপিআই অ্যাপ কীভাবে কনফিগার এবং চালাতে হয় তা শিখতে, কুইকস্টার্টস ওভারভিউ পড়ুন।