ওভারভিউ

ক্লাসরুম এপিআই আপনাকে Google ক্লাসরুমে কোর্স এবং রোস্টার পরিচালনা করার জন্য একটি আরামদায়ক ইন্টারফেস প্রদান করে। উপরন্তু, ক্লাসরুম শেয়ার বোতামটি ডেভেলপার এবং বিষয়বস্তুর মালিকদের তাদের বিষয়বস্তু শ্রেণীকক্ষে শেয়ার করতে সক্ষম করে।

কে API ব্যবহার করতে পারেন?

Google Workspace for Education ডোমেন অ্যাডমিনিস্ট্রেটররা এপিআই ব্যবহার করে শিক্ষকদের তরফে প্রোগ্রাম্যাটিকভাবে কোর্স প্রভিশন করতে, ক্লাসরুমের সাথে স্টুডেন্ট ইনফরমেশন সিস্টেম সিঙ্ক করতে এবং তাদের ডোমেনে পড়ানো ক্লাসে প্রাথমিক দৃশ্যমানতা পেতে পারেন।

অ্যাপ্লিকেশন ডেভেলপাররা ক্লাসরুমের সাথে তাদের অ্যাপ একত্রিত করতে Classroom API ব্যবহার করতে পারেন। শিক্ষকদের কাছ থেকে ক্লাস এবং রোস্টার দেখার অনুমতির অনুরোধ করতে এই অ্যাপগুলিকে OAuth 2.0 ব্যবহার করতে হবে। প্রশাসকরা তাদের ডোমেনের শিক্ষক এবং শিক্ষার্থীরা তাদের Google ক্লাসরুম ডেটা অ্যাক্সেস করার জন্য অ্যাপগুলিকে অনুমোদন দিতে পারে কিনা তা সীমাবদ্ধ করতে পারে

ওয়েবসাইটের মালিক এবং কন্টেন্ট ডেভেলপাররা ক্লাসরুম শেয়ার বোতাম ব্যবহার করতে পারেন যাতে ছাত্র এবং শিক্ষকরা ক্লাসরুমে বিষয়বস্তু শেয়ার করতে পারেন।

সমস্ত API এবং ক্লাসরুম শেয়ার বোতাম ইন্টিগ্রেশন ক্লাসরুম ব্র্যান্ড নির্দেশিকা অনুসরণ করা উচিত।

API ওভারভিউ

Classroom API-এ বিভিন্ন ধরনের সত্তা রয়েছে যা ক্লাসরুম ইন্টারফেসের ক্লাস, শিক্ষক এবং ছাত্রদের সাথে সঙ্গতিপূর্ণ। এই সত্তাগুলির মধ্যে কয়েকটির Classroom-এ যা আছে তা ছাড়াও API-এর জন্য নির্দিষ্ট অতিরিক্ত বৈশিষ্ট্য রয়েছে। প্রাথমিক সত্তা প্রকারগুলি হল:

API সংস্থান এবং পদ্ধতি সম্পর্কে বিস্তারিত তথ্যের জন্য, Classroom API রেফারেন্স দেখুন।

কোর্স মেটাডেটা এবং উপনাম

কোর্সগুলি একটি ক্লাসের প্রতিনিধিত্ব করে, যেমন "M. Smith's 4th period math," এবং এর নির্ধারিত শিক্ষক, ছাত্র তালিকা এবং মেটাডেটা। প্রতিটি কোর্স সার্ভার দ্বারা নির্ধারিত একটি অনন্য ID দ্বারা চিহ্নিত করা হয়। কোর্স রিসোর্স বিশেষভাবে কোর্স সম্পর্কে সমস্ত মেটাডেটা অন্তর্ভুক্ত করে, যেমন নাম, বিবরণ, অবস্থান এবং সময়। কোর্স রোস্টারগুলি ছাত্র , শিক্ষক এবং আমন্ত্রণ সংস্থান এবং তাদের পদ্ধতির মাধ্যমে পরিচালিত হয়।

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

  • ডোমেন: ডোমেন নেমস্পেস উপনাম তৈরি করার জন্য উপযোগী যে সমস্ত ব্যবহারকারীর অ্যাক্সেস প্রয়োজন, কিন্তু এটি কোনো একটি প্রোগ্রামের জন্য নির্দিষ্ট নয়। উদাহরণস্বরূপ, একটি কোর্সের জন্য বিকল্প তালিকা, যেমন MATH 127 এবং COMSCI 127, ডোমেন নেমস্পেসে তৈরি করা উচিত। ডোমেন নামস্থানে উপনামগুলি শুধুমাত্র ডোমেন প্রশাসকদের দ্বারা তৈরি করা যেতে পারে তবে একটি ডোমেনের সমস্ত ব্যবহারকারীর কাছে দৃশ্যমান।
  • ডেভেলপার প্রজেক্ট: ডেভেলপার প্রজেক্ট নেমস্পেস একটি অ্যাপ্লিকেশনের নির্দিষ্ট উপনাম পরিচালনার জন্য উপযোগী। উদাহরণস্বরূপ, একটি অ্যাপ্লিকেশন যা কোর্সের জন্য বিকল্প শনাক্তকারী ব্যবহার করে তার শনাক্তকারীকে ক্লাসরুম কোর্সে ম্যাপ করতে উপনাম তৈরি করতে পারে। এই নামস্থানে তৈরি উপনামগুলি একটি নির্দিষ্ট Google API কনসোলের সাথে আবদ্ধ। একটি অ্যাপ্লিকেশনের যেকোনো ব্যবহারকারী সেই অ্যাপ্লিকেশনটির বিকাশকারী প্রকল্পের জন্য নামস্থানে উপনাম তৈরি করতে এবং দেখতে পারেন।

কোর্স মেটাডেটা এবং উপনাম পরিচালনা সম্পর্কে আরও তথ্যের জন্য, কোর্স পরিচালনা করুন দেখুন।

কোর্স রোস্টার এবং ব্যবহারকারী

ছাত্র এবং শিক্ষক হল একটি ব্যবহারকারীর প্রোফাইল এবং একটি কোর্সের মধ্যে নির্দিষ্ট ম্যাপিং, যা কোর্সে সেই ব্যবহারকারীর ভূমিকার প্রতিনিধিত্ব করে৷ ছাত্র এবং শিক্ষকের পদবি বিশ্বব্যাপী নয়: একজন ব্যবহারকারীকে একটি কোর্সের জন্য একজন শিক্ষক এবং অন্যটিতে একজন ছাত্র হিসেবে নিয়োগ করা যেতে পারে। উপাধি "ছাত্র" বা "শিক্ষক" একটি নির্দিষ্ট কোর্সে একটি নির্দিষ্ট ব্যবহারকারীর জন্য অনুমতির একটি সেট প্রতিনিধিত্ব করে।

ছাত্ররা

একটি ছাত্র সম্পদ এমন একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে যিনি একজন ছাত্র হিসেবে নথিভুক্ত হয়েছেন

একটি নির্দিষ্ট কোর্স। শিক্ষার্থীদের সেই কোর্সের জন্য কোর্সের বিবরণ এবং শিক্ষকদের দেখার অনুমতি দেওয়া হয়েছে।

শিক্ষকরা

একজন শিক্ষক সম্পদ এমন একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে যিনি একটি নির্দিষ্ট কোর্স শেখান।

শিক্ষকদের কোর্সের বিবরণ দেখতে এবং পরিবর্তন করতে, শিক্ষক এবং ছাত্রদের দেখতে এবং অতিরিক্ত শিক্ষক ও ছাত্রদের পরিচালনা করার অনুমতি রয়েছে।

আমন্ত্রণপত্র এবং তাদের সংশ্লিষ্ট পদ্ধতিগুলি কোর্সে ছাত্র এবং শিক্ষকদের যোগ করার একটি সুবিধাজনক উপায় প্রদান করে। আমন্ত্রণগুলি তৈরি করা ব্যবহারকারীদেরকে আপনি সরাসরি শিক্ষক এবং ছাত্র সম্পদের মাধ্যমে যোগ করার পরিবর্তে একটি কোর্সে যোগ দেবেন কি না তা চয়ন করতে দেয়৷

UserProfiles একটি ব্যবহারকারীর ডোমেন প্রোফাইলে একটি ম্যাপিং প্রতিনিধিত্ব করে যা ব্যবহারকারীর অনন্য ID বা ইমেল ঠিকানা দ্বারা চিহ্নিত করা হয় যা ডিরেক্টরি API দ্বারা প্রত্যাবর্তিত হয়। বর্তমান ব্যবহারকারী "me" শর্টহ্যান্ড ব্যবহার করে তাদের নিজস্ব আইডিও উল্লেখ করতে পারে।

রোস্টার পরিচালনার বিষয়ে আরও তথ্যের জন্য, শিক্ষক এবং ছাত্রদের পরিচালনা দেখুন।

কোর্সওয়ার্ক এবং ছাত্র জমা

একটি CourseWork আইটেম একটি কোর্সে ছাত্রদের একটি গ্রুপের জন্য নির্ধারিত একটি একক টাস্ক প্রতিনিধিত্ব করে। এতে বিবরণ, নির্ধারিত তারিখ এবং উপকরণের পাশাপাশি মেটাডেটা যেমন সৃষ্টির সময় রয়েছে। উপাদানগুলির মধ্যে একটি শিরোনাম, থাম্বনেইল এবং URL, সেইসাথে একটি শনাক্তকারী রয়েছে যা উপযুক্ত API (যেমন ড্রাইভ, YouTube) এর সাথে ব্যবহার করা যেতে পারে৷

CourseWork আইটেম নিম্নলিখিত ধরনের কাজগুলির মধ্যে একটি বর্ণনা করে:

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

একটি CourseWork আইটেমের জন্য ছাত্রদের কাজ একটি StudentSubmission দ্বারা প্রতিনিধিত্ব করা হয়। এটি একটি প্রতিক্রিয়া এবং অতিরিক্ত মেটাডেটা যেমন একটি রাষ্ট্র এবং নির্ধারিত গ্রেড নিয়ে গঠিত।

স্টুডেন্ট সাবমিশনের বিষয়বস্তু সংশ্লিষ্ট কোর্সওয়ার্ক আইটেমের ধরনের উপর নির্ভর করে:

  • একটি অ্যাসাইনমেন্টের জন্য জমা দেওয়া ওয়ার্কশীট এবং সংযুক্তিগুলি, তাদের শিরোনাম, থাম্বনেইল এবং URL সহ, সেইসাথে শনাক্তকারী যা উপযুক্ত API যেমন ড্রাইভ বা YouTube এর সাথে ব্যবহার করা যেতে পারে৷
  • একটি সংক্ষিপ্ত উত্তর প্রশ্নের উত্তর বা বহুনির্বাচনী প্রশ্নের উত্তর।

কোর্সওয়ার্ক পরিচালনা এবং ছাত্র জমা দেওয়ার বিষয়ে আরও তথ্যের জন্য, ক্লাসওয়ার্ক পরিচালনা করুন দেখুন।

ক্লাসরুম অ্যাড-অন

একটি অ্যাড-অন হল একটি অংশীদার দ্বারা পরিবেশিত UI এবং ব্যাকএন্ড সাধারণত একটি iframe এ প্রদর্শিত হয়৷ অ্যাড-অনগুলি একটি পোস্টে সংযুক্তি হিসাবে প্রদর্শিত হয়, যা Announcements , CourseWork , বা CourseWorkMaterials হতে পারে৷

অ্যাড-অন সংযুক্তি একটি কার্যকলাপ বা বিষয়বস্তু হতে পারে।

  • অ্যাক্টিভিটি অ্যাটাচমেন্টের জন্য একজন শিক্ষার্থীকে একটি স্বতন্ত্র জমা দেওয়া সম্পূর্ণ এবং চালু করতে হবে। উদাহরণের মধ্যে রয়েছে কুইজ, অঙ্কন বা গেম। একটি কার্যকলাপ জমা ঐচ্ছিকভাবে গ্রেড করা যেতে পারে.
  • বিষয়বস্তু সংযুক্তি একটি ছাত্র জমা প্রয়োজন হয় না. শিক্ষার্থীর সংযুক্তি চালু করার দরকার নেই এবং এটি গ্রেড করা হয়নি। উদাহরণ ফটো, নিবন্ধ এবং ভিডিও অন্তর্ভুক্ত.

আরও তথ্যের জন্য অ্যাড-অন উন্নয়ন নির্দেশিকা দেখুন।

দ্রুত শুরু

আপনার পরিবেশ সেট আপ করতে এবং এপিআই এর সাথে সাথেই শুরু করতে, একটি দ্রুত শুরু করার চেষ্টা করুন:

Google APIs এক্সপ্লোরারের সাথে পরীক্ষা করুন

লাইভ ডেটাতে কলিং পদ্ধতি পরীক্ষা করতে, Google APIs এক্সপ্লোরার ব্যবহার করে দেখুন। শুরু করার জন্য আপনাকে কোনো কোড লিখতে হবে না, তবে সচেতন থাকুন যে APIs এক্সপ্লোরার ব্যবহার করে আপনি যে কাজগুলি করেন তা বিদ্যমান ডেটা পরিবর্তন করতে পারে৷

পদ্ধতিগুলি কল করা শুরু করার একটি উপায় হল courses.list() পদ্ধতিতে একটি কল করা। এই পদ্ধতিতে কোনো অনুরোধের প্যারামিটারের প্রয়োজন নেই এবং আপনি অন্যান্য API কলের জন্য অনুরোধের পরামিতি হিসাবে ব্যবহার করার জন্য কোর্সের ফেরত তালিকা থেকে একটি id পুনরুদ্ধার করতে পারেন। আপনার যদি কোনো কোর্স না থাকে, তাহলে আপনি courses.create() পদ্ধতি ব্যবহার করে একটি তৈরি করতে পারেন।

আপনি API রেফারেন্সও অন্বেষণ করতে পারেন।