এই নির্দেশিকাটি প্রাথমিক উপাদানগুলির একটি ওভারভিউ প্রদান করে যা Google Classroom API তৈরি করে। Google Classroom API সম্পদ এবং পরিষেবা নিয়ে গঠিত। সংস্থানগুলি Google ক্লাসরুমে সত্তার প্রতিনিধিত্ব করে, যেমন একটি কোর্স বা অ্যাসাইনমেন্ট, এবং পরিষেবাগুলি এই সংস্থানগুলি পুনরুদ্ধার এবং পরিচালনা করে৷ এই সত্তাগুলির মধ্যে কয়েকটির Classroom-এ যা আছে তা ছাড়াও API-এর জন্য নির্দিষ্ট অতিরিক্ত বৈশিষ্ট্য রয়েছে। প্রাথমিক সত্তা প্রকারগুলি হল:
| সত্তা | শ্রেণীকক্ষে প্রতিনিধিত্ব |
|---|---|
| কোর্স | একটি ক্লাস, যেমন "M. Smith's 4th period math"। |
| উপনাম | একটি কোর্সের জন্য একটি বিকল্প আইডি। |
| আমন্ত্রণ | একটি ক্লাসে ব্যবহারকারীদের যোগ করার একটি উপায়। |
| ছাত্ররা | ক্লাসে একজন ছাত্র। |
| শিক্ষকরা | ক্লাসে একজন শিক্ষক। |
| ব্যবহারকারীর প্রোফাইল | একজন ব্যবহারকারী সাধারণভাবে, ছাত্র বা শিক্ষকের প্রসঙ্গের বাইরে। |
| কোর্সওয়ার্ক | একটি ক্লাসে একটি অ্যাসাইনমেন্ট। |
| ছাত্র জমা | একজন শিক্ষার্থী একটি প্রদত্ত অ্যাসাইনমেন্টের জন্য কাজ করে, যেমন উত্তর বা ওয়ার্কশীট। |
| কোর্স ওয়ার্ক ম্যাটেরিয়ালস | একটি ক্লাসে শিক্ষার্থীদের জন্য উপকরণ। |
| ঘোষণা | একটি ক্লাসে শিক্ষার্থীদের জন্য একটি ঘোষণা। |
| AddOnAttachment | একটি অ্যাসাইনমেন্ট বা উপাদানের বিষয়বস্তু বা কার্যকলাপ যা সাধারণত একটি এমবেডেড আইফ্রেম হিসাবে প্রদর্শিত হয়। |
| বিষয় | একটি ক্লাসে অ্যাসাইনমেন্ট এবং উপকরণগুলির একটি ভিজ্যুয়াল গ্রুপিং। |
| নিবন্ধন | ক্লাস রোস্টারের মতো ডেটাতে পরিবর্তনের জন্য আপনার অ্যাপে বিজ্ঞপ্তি পাঠানোর একটি নির্দেশ। |
রিসোর্সের ইনস্ট্যান্স পড়া, আপডেট করা এবং মুছে ফেলার মতো স্ট্যান্ডার্ড ক্রিয়াকলাপের জন্য বেশিরভাগ সংস্থানগুলিতে পরিষেবা পদ্ধতি রয়েছে। কিছু সংস্থানগুলিতে অন্যান্য ক্রিয়াকলাপের জন্য কাস্টম পদ্ধতিও রয়েছে, যেমন একটি নির্দিষ্ট অ্যাসাইনমেন্ট বরাদ্দ করা শিক্ষার্থীদের তালিকা পরিবর্তন করা।
API সংস্থান এবং পদ্ধতি সম্পর্কে বিস্তারিত তথ্যের জন্য, Classroom API রেফারেন্স দেখুন।
সম্পদ সম্পর্ক ওভারভিউ
- কোর্সটি হল গুগল ক্লাসরুমের ভিত্তিগত ডেটা অবজেক্ট।
- উপনামগুলি
Coursesবিকল্প শনাক্তকারী হিসাবে ব্যবহৃত হয়। - একটি
Courseশিক্ষক বা ছাত্র হওয়ার জন্য ব্যবহারকারীর প্রোফাইলকে আমন্ত্রণ জানাতে আমন্ত্রণগুলি ব্যবহার করা হয়, তবে ব্যবহারকারীদের সরাসরি Google Workspace for Education ডোমেন অ্যাডমিনিস্ট্রেটরদের দ্বারা যোগ করা যেতে পারে। - শিক্ষকরা স্ট্রিম আইটেম তৈরি করে এবং তাদের কোর্সে শিক্ষার্থীদের সাথে শেয়ার করে। সম্ভাব্য স্ট্রীম আইটেম প্রকারগুলি হল কোর্সওয়ার্ক , কোর্স ওয়ার্ক ম্যাটেরিয়ালস , এবং ঘোষণা ৷
CourseWorkএবংCourseWorkMaterialsদৃশ্যত বিষয়গুলিতে সংগঠিত করা যেতে পারে এবং এতে AddOnAttachments থাকতে পারে। ছাত্ররা তাদেরCourseWorkজন্য স্টুডেন্ট সাবমিশন জমা দেয়। - এই ডেটার কিছু পরিবর্তন হলে ডেভেলপাররা বিজ্ঞপ্তি পেতে নিবন্ধন তৈরি করতে পারে।
যেসব ডোমেনে Google Workspace for Education-এর সাবস্ক্রাইব করা হয় তাদের জন্য Google Classroom পাওয়া যায়। ক্লাসরুম প্রসঙ্গে একটি ডোমেন সাধারণত একটি স্কুল জেলার প্রতিনিধিত্ব করে। আপনি ডেভেলপমেন্টের উদ্দেশ্যে একটি Google Workspace for Education টেস্ট ডোমেন তৈরি করতে পারেন, যা আপনাকে প্রকৃত ব্যবহারকারীদের প্রভাবিত না করেই Classroom-এর প্রোডাকশন ইনস্ট্যান্সের নিয়ন্ত্রণ দেয়।
কোর্স এবং উপনাম
Courses একটি ক্লাসের প্রতিনিধিত্ব করে, যেমন "এম. স্মিথের 4র্থ পিরিয়ডের গণিত", এবং এর নিয়োগকৃত শিক্ষক, ছাত্র তালিকা এবং মেটাডেটা। প্রতিটি কোর্স সার্ভার দ্বারা নির্ধারিত একটি অনন্য ID দ্বারা চিহ্নিত করা হয়। Course রিসোর্স বিশেষভাবে কোর্স সম্পর্কে সমস্ত মেটাডেটা অন্তর্ভুক্ত করে, যেমন নাম, বিবরণ, অবস্থান এবং সময়। কোর্স রোস্টারগুলি ছাত্র , শিক্ষক এবং আমন্ত্রণ সংস্থান এবং তাদের পদ্ধতির মাধ্যমে পরিচালিত হয়।
Aliases হল একটি ক্লাসের জন্য বিকল্প শনাক্তকারী যা একটি কোর্সের সাথে যুক্ত হতে পারে এবং অনন্য আইডির জায়গায় ব্যবহার করা যেতে পারে। প্রতিটি উপনাম একটি নেমস্পেসে বিদ্যমান যা কে এটি তৈরি করতে এবং দেখতে পারে তা সীমাবদ্ধ করে। দুটি নামস্থান সমর্থিত:
- ডোমেন: ডোমেন নেমস্পেস উপনাম তৈরি করার জন্য উপযোগী যে সমস্ত ব্যবহারকারীর অ্যাক্সেস প্রয়োজন, কিন্তু এটি কোনো একটি প্রোগ্রামের জন্য নির্দিষ্ট নয়। উদাহরণস্বরূপ, একটি কোর্সের জন্য বিকল্প তালিকা, যেমন MATH 127 এবং COMSCI 127, ডোমেন নেমস্পেসে তৈরি করা উচিত। ডোমেন নামস্থানে উপনামগুলি শুধুমাত্র ডোমেন প্রশাসকদের দ্বারা তৈরি করা যেতে পারে তবে একটি ডোমেনের সমস্ত ব্যবহারকারীর কাছে দৃশ্যমান।
- ডেভেলপার প্রজেক্ট: ডেভেলপার প্রজেক্ট নেমস্পেস একটি অ্যাপ্লিকেশনের নির্দিষ্ট উপনাম পরিচালনার জন্য উপযোগী। উদাহরণস্বরূপ, একটি অ্যাপ্লিকেশন যা কোর্সের জন্য বিকল্প শনাক্তকারী ব্যবহার করে তার শনাক্তকারীকে ক্লাসরুম কোর্সে ম্যাপ করতে উপনাম তৈরি করতে পারে। এই নামস্থানে তৈরি উপনামগুলি একটি নির্দিষ্ট Google API কনসোলের সাথে আবদ্ধ। একটি অ্যাপ্লিকেশনের যেকোনো ব্যবহারকারী সেই অ্যাপ্লিকেশনটির বিকাশকারী প্রকল্পের জন্য নামস্থানে উপনাম তৈরি করতে এবং দেখতে পারেন।
কোর্স মেটাডেটা এবং উপনাম পরিচালনা সম্পর্কে আরও তথ্যের জন্য, কোর্স পরিচালনা করুন দেখুন।
কোর্স রোস্টার এবং ব্যবহারকারী
Students এবং Teachers হল একটি ব্যবহারকারীর প্রোফাইল এবং একটি কোর্সের মধ্যে নির্দিষ্ট ম্যাপিং, যা কোর্সে সেই ব্যবহারকারীর ভূমিকার প্রতিনিধিত্ব করে৷ ছাত্র এবং শিক্ষকের পদবি বিশ্বব্যাপী নয়: একজন ব্যবহারকারীকে একটি কোর্সের জন্য একজন শিক্ষক এবং অন্যটিতে একজন ছাত্র হিসেবে নিয়োগ করা যেতে পারে। উপাধি "ছাত্র" বা "শিক্ষক" একটি নির্দিষ্ট কোর্সে একটি নির্দিষ্ট ব্যবহারকারীর জন্য অনুমতির একটি সেট প্রতিনিধিত্ব করে।
- ছাত্ররা
একটি
Studentসম্পদ এমন একটি ব্যবহারকারীকে প্রতিনিধিত্ব করে যিনি একটি নির্দিষ্ট কোর্সে ছাত্র হিসাবে নথিভুক্ত হন।শিক্ষার্থীদের সেই কোর্সের জন্য কোর্সের বিবরণ এবং শিক্ষকদের দেখার অনুমতি দেওয়া হয়েছে।
- শিক্ষকরা
একজন
Teacherসম্পদ এমন একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে যিনি একটি নির্দিষ্ট কোর্স শেখান।শিক্ষকদের কোর্সের বিবরণ দেখতে এবং পরিবর্তন করতে, শিক্ষক এবং ছাত্রদের দেখতে এবং অতিরিক্ত শিক্ষক ও ছাত্রদের পরিচালনা করার অনুমতি রয়েছে।
Invitations এবং তাদের সংশ্লিষ্ট পদ্ধতিগুলি কোর্সে ছাত্র এবং শিক্ষকদের যোগ করার একটি সুবিধাজনক উপায় প্রদান করে। আমন্ত্রণগুলি তৈরি করা ব্যবহারকারীদেরকে আপনি সরাসরি শিক্ষক এবং ছাত্র সম্পদের মাধ্যমে যোগ করার পরিবর্তে একটি কোর্সে যোগ দেবেন কি না তা চয়ন করতে দেয়৷
UserProfiles একটি ব্যবহারকারীর ডোমেন প্রোফাইলে একটি ম্যাপিং প্রতিনিধিত্ব করে যা ব্যবহারকারীর অনন্য ID বা ইমেল ঠিকানা দ্বারা চিহ্নিত করা হয় যা ডিরেক্টরি API দ্বারা প্রত্যাবর্তিত হয়। বর্তমান ব্যবহারকারী "me" শর্টহ্যান্ড ব্যবহার করে তাদের নিজস্ব আইডিও উল্লেখ করতে পারে।
UserProfiles পরিষেবাটি Guardians পরিচালনা এবং আমন্ত্রণ জানাতেও ব্যবহার করা যেতে পারে, যা একজন ছাত্র এবং অভিভাবকের মধ্যে একটি ম্যাপিং। শ্রেণীকক্ষে অভিভাবকদের কিছু ছাত্র তথ্যের অ্যাক্সেস আছে, যেমন তাদের অ্যাসাইনমেন্ট।
রোস্টার পরিচালনার বিষয়ে আরও তথ্যের জন্য, শিক্ষক এবং ছাত্রদের পরিচালনা দেখুন।
কোর্সওয়ার্ক এবং ছাত্র জমা
একটি CourseWork আইটেম একটি কোর্সে ছাত্রদের একটি গ্রুপের জন্য নির্ধারিত একটি একক টাস্ক প্রতিনিধিত্ব করে। এতে বিবরণ, নির্ধারিত তারিখ এবং উপকরণের পাশাপাশি মেটাডেটা যেমন সৃষ্টির সময় রয়েছে। উপাদানগুলির মধ্যে একটি শিরোনাম, থাম্বনেইল এবং URL, সেইসাথে একটি শনাক্তকারী রয়েছে যা উপযুক্ত API (যেমন ড্রাইভ, YouTube) এর সাথে ব্যবহার করা যেতে পারে৷
CourseWork আইটেম নিম্নলিখিত ধরনের কাজগুলির মধ্যে একটি বর্ণনা করে:
- একটি অ্যাসাইনমেন্ট যা শিক্ষার্থীরা ওয়ার্কশীট বা অন্যান্য সংযুক্তি জমা দিয়ে সম্পূর্ণ করে।
- একটি সংক্ষিপ্ত উত্তর প্রশ্ন বা বহুনির্বাচনী প্রশ্ন।
একটি CourseWork আইটেমের জন্য ছাত্রদের কাজ একটি StudentSubmission দ্বারা প্রতিনিধিত্ব করা হয়। এটি একটি প্রতিক্রিয়া এবং অতিরিক্ত মেটাডেটা যেমন একটি রাষ্ট্র এবং নির্ধারিত গ্রেড নিয়ে গঠিত।
StudentSubmission সাবমিশনের বিষয়বস্তু সংশ্লিষ্ট CourseWork আইটেমের ধরনের উপর নির্ভর করে:
- একটি অ্যাসাইনমেন্টের জন্য জমা দেওয়া ওয়ার্কশীট এবং সংযুক্তিগুলি, তাদের শিরোনাম, থাম্বনেইল এবং URL সহ, সেইসাথে শনাক্তকারী যা উপযুক্ত API যেমন ড্রাইভ বা YouTube এর সাথে ব্যবহার করা যেতে পারে৷
- একটি সংক্ষিপ্ত উত্তর প্রশ্নের উত্তর বা বহুনির্বাচনী প্রশ্নের উত্তর।
কোর্সওয়ার্ক পরিচালনা এবং ছাত্র জমা দেওয়ার বিষয়ে আরও তথ্যের জন্য, ক্লাসওয়ার্ক পরিচালনা করুন দেখুন।
কোর্সওয়ার্ক উপকরণ এবং ঘোষণা
CourseWork এর মতোই, CourseWorkMaterials একটি কোর্সে শিক্ষার্থীদের একটি গোষ্ঠীকে বরাদ্দ করা বিষয়বস্তুকে উপস্থাপন করে, একটি শিরোনাম এবং বিবরণের মতো বিবরণ সহ উপকরণ সহ। যাইহোক, CourseWork বিপরীতে, CourseWorkMaterials শিক্ষার্থীদের কোনো শিল্পকর্ম জমা দেওয়ার প্রয়োজন হয় না। যেমন, কোন নির্ধারিত তারিখ নেই, এবং CourseWorkMaterials এর জন্য StudentSubmissions বিদ্যমান নেই। শিক্ষকরা CourseWorkMaterials ব্যবহার করতে পারেন প্রস্তাবিত রিডিং পোস্ট করতে, একটি সিলেবাস বা ক্লাসরুমের নিয়ম, উদাহরণস্বরূপ।
Announcements ছাত্রদের একটি গোষ্ঠীর সাথে ভাগ করা বিষয়বস্তুরও প্রতিনিধিত্ব করে, কিন্তু শিরোনামের মতো বিশদ বিবরণ থাকে না এবং CourseWork বা CourseWorkMaterials মতো Topics দ্বারা সংগঠিত হতে পারে না৷ শিক্ষকরা ক্লাসে অনুস্মারক বা নোটিশ ঘোষণা করতে এগুলি ব্যবহার করতে পারেন।
বিষয়
একটি ক্লাসের মধ্যে CourseWork এবং CourseWorkMaterials দৃশ্যমানভাবে সংগঠিত করতে Topics ব্যবহার করা হয়। এগুলিকে "ঐচ্ছিক" এবং "প্রয়োজনীয়" বা "ইউনিট 1" এবং "ইউনিট 2" তে গ্রুপ করার জন্য ব্যবহার করা যেতে পারে, উদাহরণস্বরূপ।
ক্লাসরুম অ্যাড-অন
একটি অ্যাড-অন হল একটি ডেভেলপার-সার্ভড UI এবং ব্যাকএন্ড সাধারণত একটি iframe-এ প্রদর্শিত হয়। অ্যাড-অনগুলি একটি স্ট্রিম আইটেমে সংযুক্তি হিসাবে উপস্থিত হয়। স্ট্রীম আইটেম যেকোন Announcements , CourseWork , বা CourseWorkMaterials হতে পারে। অ্যাড-অন সংযুক্তিগুলি একটি AddOnAttachment দ্বারা প্রতিনিধিত্ব করা হয়।
অ্যাড-অন সংযুক্তি একটি কার্যকলাপ বা বিষয়বস্তু হতে পারে।
- অ্যাক্টিভিটি অ্যাটাচমেন্টের জন্য একজন শিক্ষার্থীকে একটি স্বতন্ত্র জমা দেওয়া সম্পূর্ণ এবং চালু করতে হবে। উদাহরণের মধ্যে রয়েছে কুইজ, অঙ্কন বা গেম। একটি কার্যকলাপ জমা ঐচ্ছিকভাবে গ্রেড করা যেতে পারে.
- বিষয়বস্তু সংযুক্তি একটি ছাত্র জমা প্রয়োজন হয় না. শিক্ষার্থীর সংযুক্তি চালু করার দরকার নেই এবং এটি গ্রেড করা হয়নি। উদাহরণ ফটো, নিবন্ধ এবং ভিডিও অন্তর্ভুক্ত.
আরও তথ্যের জন্য অ্যাড-অন উন্নয়ন নির্দেশিকা দেখুন।
নিবন্ধন
Google ক্লাসরুমে নির্দিষ্ট ডেটা পরিবর্তন হলে অ্যাপ্লিকেশনগুলি বিজ্ঞপ্তির জন্য সদস্যতা নিতে পারে। উদাহরণস্বরূপ, যখন একটি কোর্সের রোস্টার আপডেট করা হয়। Registrations আপনার আবেদনে এই বিজ্ঞপ্তিগুলি পাঠানোর জন্য একটি নির্দেশের প্রতিনিধিত্ব করে৷
আরও জানতে পুশ বিজ্ঞপ্তি নির্দেশিকা দেখুন।