API সম্পদ

এই নির্দেশিকাটি প্রাথমিক উপাদানগুলির একটি ওভারভিউ প্রদান করে যা 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 পরিচালনা এবং আমন্ত্রণ জানাতেও ব্যবহার করা যেতে পারে, যা একজন ছাত্র এবং অভিভাবকের মধ্যে একটি ম্যাপিং। শ্রেণীকক্ষে অভিভাবকদের কিছু ছাত্র তথ্যের অ্যাক্সেস আছে, যেমন তাদের অ্যাসাইনমেন্ট।

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

স্ট্রিম আইটেম

স্ট্রিম আইটেমগুলি হল পোস্ট করা বিষয়বস্তুর টুকরোগুলি একটি কোর্সের সদস্যদের সাথে ভাগ করা৷ বিকাশকারী এবং শিক্ষকরা তিনটি স্ট্রিম আইটেম প্রকার তৈরি করতে পারেন: Announcement , CourseWork , এবং CourseWorkMaterial ৷

শিক্ষকরা ক্লাসরুম UI-তে স্ট্রীম পৃষ্ঠার শীর্ষে Announcements তৈরি করেন। শিক্ষকরা ক্লাসওয়ার্ক ট্যাবে তৈরি বোতামে ক্লিক করে CourseWork এবং CourseWorkMaterials তৈরি করেন। বিকাশকারীরা ক্লাসরুম API-এর মাধ্যমে প্রোগ্রাম্যাটিকভাবে সমস্ত স্ট্রিম আইটেম প্রকার তৈরি করতে পারে।

স্ট্রিম আইটেমগুলির ক্ষেত্রে নিম্নলিখিতগুলি সত্য:

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

কপি করা স্ট্রিম আইটেম

শিক্ষকরা একটি কোর্স অনুলিপি করে, একটি অ্যাসাইনমেন্ট পুনরায় ব্যবহার করে বা একাধিক কোর্সে একটি স্ট্রিম আইটেম প্রকাশ করে একটি স্ট্রিম আইটেম অনুলিপি করতে পারে। যেকোন নতুন কপির আলাদা আইডেন্টিফায়ার থাকবে, যদি আপনি ক্লাসরুম অ্যাড-অন তৈরি করেন তাহলে এটি একটি গুরুত্বপূর্ণ বিবেচ্য হতে পারে। একটি অ্যাড-অন কীভাবে এই পরিস্থিতিগুলি পরিচালনা করতে পারে তা বোঝার জন্য অনুলিপি করা সামগ্রী সম্পর্কে আমাদের গাইড পড়ুন।

কোর্সওয়ার্ক এবং স্টুডেন্ট সাবমিশন

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

প্রতিটি 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 আপনার আবেদনে এই বিজ্ঞপ্তিগুলি পাঠানোর জন্য একটি নির্দেশের প্রতিনিধিত্ব করে৷

আরও জানতে পুশ বিজ্ঞপ্তি নির্দেশিকা দেখুন।