REST Resource: courses

রিসোর্স: কোর্স

Classroom-এ একটি কোর্স।

JSON উপস্থাপনা 
{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  },
  "subject": string,
  "learningStandardSettings": {
    object (CourseLearningStandardSettings)
  },
  "levels": string
}
ফিল্ড
id

string

Classroom-এর মাধ্যমে অ্যাসাইন করা এই কোর্সের শনাক্তকারী।

creating a course হলে, আপনি বিকল্প হিসেবে এই শনাক্তকারীকে অনুরোধে alias string হিসেবে সেট করতে পারেন যাতে সংশ্লিষ্ট উপনাম তৈরি করা যায়। Classroom এখনও id অ্যাসাইন করে এবং কোর্স তৈরি করার পরে এটি আপডেট করা যাবে না।

কোর্স আপডেট মাস্কে এই ফিল্ড উল্লেখ করলে সমস্যা হয়।
name

string

কোর্সের নাম। যেমন, "দশম শ্রেণীর জীববিদ্যা"। নাম লিখতে হবে। এটি ১ থেকে ৭৫০টি অক্ষরের মধ্যে এবং একটি সঠিক UTF-8 স্ট্রিং হতে হবে।
section

string

কোর্সের বিভাগ। যেমন, "পিরিয়ড ২"। সেট করা হলে, এই ফিল্ডে অবশ্যই সঠিক UTF-8 স্ট্রিং থাকতে হবে এবং ২৮০০ অক্ষরের বেশি হওয়া চলবে না।
descriptionHeading

string

বিবরণের জন্য ঐচ্ছিক শিরোনাম। যেমন, "দশম শ্রেণীর জীববিদ্যা ক্লাসে স্বাগত।" সেট করা হলে, এই ফিল্ডে অবশ্যই সঠিক UTF-8 স্ট্রিং থাকতে হবে এবং ৩৬০০ অক্ষরের বেশি হওয়া চলবে না।
description

string

ঐচ্ছিক বিবরণ। যেমন, "আমরা টেক্সটবুক, অতিথি বক্তৃতা এবং ল্যাব ওয়ার্কের সমন্বয়ে জীবন্ত প্রাণীর গঠন সম্পর্কে শিখব। উত্তেজিত হওয়ার জন্য প্রস্তুত থাকুন!" সেট করা হলে, এই ফিল্ডে অবশ্যই একটি সঠিক UTF-8 স্ট্রিং থাকতে হবে এবং এটি ৩০,০০০ অক্ষরের বেশি হতে পারবে না।
room

string

রুমের লোকেশন (ঐচ্ছিক)। যেমন, "৩০১"। সেট করা হলে, এই ফিল্ডে অবশ্যই সঠিক UTF-8 স্ট্রিং থাকতে হবে এবং এটি ৬৫০ অক্ষরের বেশি হতে পারবে না।
ownerId

string

কোনও কোর্সের মালিকের শনাক্তকারী।

create course request-এর প্যারামিটার হিসেবে নির্দিষ্ট করা হলে, এই ফিল্ডটি পূরণ করতে হবে। শনাক্তকারী নিম্নলিখিতগুলির মধ্যে যেকোনও একটি হতে পারে:

  • ব্যবহারকারীর জন্য সংখ্যাসূচক শনাক্তকারী
  • ব্যবহারকারীর ইমেল আইডি
  • স্ট্রিং লিটারেল "me", যা অনুরোধকারী ব্যবহারকারীকে নির্দেশ করে

তৈরি করার অনুরোধে এটি অবশ্যই সেট করতে হবে। মালিকানা ট্রান্সফার করার জন্য অ্যাডমিনরা patch course request-এ এই ফিল্ড নির্দিষ্ট করতে পারেন। অন্যান্য ক্ষেত্রে, এটি কেবল পঠনযোগ্য।
creationTime

string (Timestamp format)

কোর্স তৈরির সময়। কোর্স আপডেট মাস্কে এই ফিল্ড উল্লেখ করলে সমস্যা হয়।

শুধুমাত্র পড়তে পারবেন।

RFC 3339 ব্যবহার করে, যেখানে জেনারেট করা আউটপুট সবসময় Z-নরমালাইজড হবে এবং ০, ৩, ৬ বা ৯টি ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ছাড়া অন্যান্য অফসেটও গ্রহণ করা হয়। যেমন: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"।
updateTime

string (Timestamp format)

এই কোর্সে সবচেয়ে সাম্প্রতিক আপডেটের সময়। কোর্স আপডেট মাস্কে এই ফিল্ড উল্লেখ করলে সমস্যা হয়।

শুধুমাত্র পড়তে পারবেন।

RFC 3339 ব্যবহার করে, যেখানে জেনারেট করা আউটপুট সবসময় Z-নরমালাইজড হবে এবং ০, ৩, ৬ বা ৯টি ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ছাড়া অন্যান্য অফসেটও গ্রহণ করা হয়। যেমন: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"।
enrollmentCode

string

এই কোর্সে যোগ দেওয়ার সময় ব্যবহার করার জন্য এনরোলমেন্ট কোড। কোর্স আপডেট মাস্কে এই ফিল্ড উল্লেখ করলে সমস্যা হয়।

শুধুমাত্র পড়তে পারবেন।
courseState

enum (CourseState)

কোর্সের স্ট্যাটাস। অনির্দিষ্ট থাকলে, ডিফল্ট অবস্থা হল PROVISIONED।
teacherGroupEmail

string

কোর্সের সব শিক্ষককে নিয়ে তৈরি Google গ্রুপের ইমেল আইডি। এই গ্রুপে ইমেল গ্রহণ করা হয় না এবং এটি শুধুমাত্র অনুমতির জন্য ব্যবহার করা যাবে।

শুধুমাত্র পড়তে পারবেন।
courseGroupEmail

string

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

শুধুমাত্র পড়তে পারবেন।
teacherFolder

object (DriveFolder)

Drive ফোল্ডার সম্পর্কিত তথ্য যা কোর্সের সব শিক্ষকের সাথে শেয়ার করা হয়েছে।

এই ফিল্ডটি শুধুমাত্র কোর্সের শিক্ষক এবং ডোমেন অ্যাডমিনিস্ট্রেটরের জন্য সেট করা হবে।

শুধুমাত্র পড়তে পারবেন।
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

এই কোর্সের "সম্পর্কে" পৃষ্ঠায় দেখানো মেটেরিয়ালের সেট।

শুধুমাত্র পড়তে পারবেন।
guardiansEnabled

boolean

এই কোর্সের জন্য অভিভাবকের বিজ্ঞপ্তি চালু করা আছে কিনা।

শুধুমাত্র পড়তে পারবেন।
calendarId

string

ক্যালেন্ডারের জন্য ক্যালেন্ডার আইডি যা কোর্সের সব মেম্বার দেখতে পাবেন, যেখানে Classroom কোর্সের কাজ ও কোর্সের ঘোষণার জন্য ইভেন্ট যোগ করে।

কোনও কোর্সের জন্য ক্যালেন্ডার অ্যাসিঙ্ক্রোনাসভাবে তৈরি করা হয় যখন কোর্সটি প্রথমবার CourseState.ACTIVE-এ সেট করা হয় (তৈরি করার সময় বা যখন এটি UI বা API-এর মাধ্যমে ACTIVE-এ আপডেট করা হয়)। তৈরি করার প্রসেস সম্পূর্ণ না হওয়া পর্যন্ত ক্যালেন্ডার আইডি পপুলেট করা হবে না।

শুধুমাত্র পড়তে পারবেন।
gradebookSettings

object (GradebookSettings)

গ্রেডবুক সেটিংস যা নির্দিষ্ট করে যে কোর্সের জন্য কোনও স্টুডেন্টের সামগ্রিক গ্রেড কীভাবে গণনা করা হবে এবং এটি কাকে দেখানো হবে।

শুধুমাত্র পড়তে পারবেন।
subject

string

ঐচ্ছিক। কোর্সের বিষয়।
learningStandardSettings

object (CourseLearningStandardSettings)

ঐচ্ছিক।

কোর্সে উপলভ্য লার্নিং স্ট্যান্ডার্ড সম্পর্কিত সেটিংস। একটি কোর্সে সর্বাধিক ২০টি লার্নিং স্ট্যান্ডার্ড সেট রুট অ্যাসাইন করা থাকতে পারে।
levels

string

ঐচ্ছিক। কোর্সের লেভেল। উদাহরণ: "নবম শ্রেণী", "মিডল স্কুল", "চতুর্থ - পঞ্চম", "K-2", "৩০০০"। সেট করা হলে, এই ফিল্ডটি অবশ্যই একটি সঠিক UTF-8 স্ট্রিং এবং ১০০০ অক্ষরের কম হতে হবে।

এই ফিল্ডটি শুধুমাত্র courses.patch পদ্ধতি ব্যবহার করে মুছে ফেলা যাবে।

CourseState

কোর্সের সম্ভাব্য স্ট্যাটাস।

Enums
COURSE_STATE_UNSPECIFIED কোর্সের কোনও স্ট্যাটাস নেই। ফেরত আসা কোনও কোর্স মেসেজ এই ভ্যালু ব্যবহার করবে না।
ACTIVE কোর্সটি অ্যাক্টিভ আছে।
ARCHIVED কোর্সটি আর্কাইভ করা হয়েছে। অন্য কোনও রাজ্যে পরিবর্তন করা ছাড়া আপনি এটি পরিবর্তন করতে পারবেন না।
PROVISIONED কোর্স তৈরি করা হয়েছে, তবে এখনও চালু করা হয়নি। এটি প্রাইমারি শিক্ষক এবং ডোমেন অ্যাডমিনিস্ট্রেটর অ্যাক্সেস করতে পারবেন, যারা এটি পরিবর্তন করতে বা ACTIVE বা DECLINED স্ট্যাটাসে পরিবর্তন করতে পারবেন। কোনও কোর্স DECLINED অবস্থায় থাকলে তবেই সেটি PROVISIONED-এ পরিবর্তন করা যেতে পারে।
DECLINED কোর্স তৈরি করা হয়েছে, কিন্তু বাতিল করা হয়েছে। কোর্সের মালিক এবং ডোমেন অ্যাডমিনিস্ট্রেটর এটি অ্যাক্সেস করতে পারবেন, তবে এটি ওয়েব UI-তে দেখানো হবে না। আপনি কোর্সটি PROVISIONED স্ট্যাটাসে পরিবর্তন করা ছাড়া অন্য কোনওভাবে পরিবর্তন করতে পারবেন না। কোনও কোর্স PROVISIONED অবস্থায় থাকলে, তবেই সেটি DECLINED-এ পরিবর্তন করা যেতে পারে।
SUSPENDED কোর্সটি সাসপেন্ড করা হয়েছে। আপনি কোর্সটি পরিবর্তন করতে পারবেন না এবং শুধুমাত্র ownerId দ্বারা শনাক্ত করা ব্যবহারকারী কোর্সটি দেখতে পারবেন। কোনও কোর্স পরিষেবার শর্তাবলী লঙ্ঘন করলে, সেটিকে এই স্ট্যাটাসে রাখা হতে পারে।

CourseMaterialSet

কোর্সের "সম্পর্কে" পৃষ্ঠায় দেখানো মেটেরিয়ালের সেট। এইসব মেটেরিয়ালের মধ্যে সিলেবাস, শিডিউল বা কোর্স সম্পর্কিত অন্যান্য ব্যাকগ্রাউন্ড তথ্য অন্তর্ভুক্ত থাকতে পারে।

JSON উপস্থাপনা 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
ফিল্ড
title

string

এই সেটের জন্য শীর্ষক।
materials[]

object (CourseMaterial)

এই সেটের সাথে অ্যাটাচ করা মেটেরিয়াল।

CourseMaterial

মেটেরিয়াল সেটের অংশ হিসেবে কোর্সে অ্যাটাচ করা মেটেরিয়াল।

JSON উপস্থাপনা 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
ফিল্ড
মেটেরিয়াল ডেটা। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
driveFile

object (DriveFile)

Google Drive ফাইল অ্যাটাচমেন্ট।
youTubeVideo

object (YouTubeVideo)

YouTube ভিডিও অ্যাটাচমেন্ট।
form

object (Form)

Google Forms অ্যাটাচমেন্ট।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

GradebookSettings

কোনও কোর্সের জন্য গ্রেডবুক সেটিংস। বিস্তারিত জানতে সহায়তা কেন্দ্র আর্টিকেল দেখুন।

JSON উপস্থাপনা 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
ফিল্ড
calculationType

enum (CalculationType)

সামগ্রিক গ্রেড কীভাবে গণনা করা হয় তা দেখায়।
displaySetting

enum (DisplaySetting)

সামগ্রিক গ্রেড কে দেখতে পাবেন তা দেখায়..
gradeCategories[]

object (GradeCategory)

কোর্সের মধ্যে কোর্সওয়ার্কের জন্য উপলভ্য গ্রেড ক্যাটেগরি।

CalculationType

মোট গ্রেড গণনা করার সম্ভাব্য পদ্ধতি।

Enums
CALCULATION_TYPE_UNSPECIFIED কোনও পদ্ধতি নির্দিষ্ট করা নেই। এটি কখনও ফেরত দেওয়া হয় না।
TOTAL_POINTS সামগ্রিক গ্রেড হল গ্রেডের যোগফলকে মোট পয়েন্টের যোগফল দিয়ে ভাগ করে পাওয়া সংখ্যা, এক্ষেত্রে বিভাগ বিবেচনা করা হয় না।
WEIGHTED_CATEGORIES সামগ্রিক গ্রেড হল বিভাগ অনুযায়ী ওয়েটেড অ্যাভারেজ।

DisplaySetting

সামগ্রিক গ্রেড দেখানোর জন্য সম্ভাব্য সেটিংস।

Enums
DISPLAY_SETTING_UNSPECIFIED কোনও সেটিং নির্দিষ্ট করা নেই। এটি কখনও ফেরত দেওয়া হয় না।
SHOW_OVERALL_GRADE শিক্ষক ও শিক্ষার্থী, উভয়ের জন্যই গ্রেডবুক ও শিক্ষার্থীর প্রোফাইলে সামগ্রিক গ্রেড দেখায়।
HIDE_OVERALL_GRADE গ্রেডবুক বা স্টুডেন্ট প্রোফাইলে সামগ্রিক গ্রেড দেখায় না।
SHOW_TEACHERS_ONLY শিক্ষকদের জন্য গ্রেডবুক ও স্টুডেন্ট প্রোফাইলে সামগ্রিক গ্রেড দেখায়। শিক্ষার্থীদের প্রোফাইলে তাদের থেকে লুকানো থাকে।

CourseLearningStandardSettings

কোনও কোর্সের জন্য লার্নিং স্ট্যান্ডার্ড সেটিংস।

JSON উপস্থাপনা 
{
  "standardSets": [
    {
      object (LearningStandardSetRoot)
    }
  ]
}
ফিল্ড
standardSets[]

object (LearningStandardSetRoot)

প্রয়োজনীয়। এই কোর্সে প্রয়োগ করা লার্নিং স্ট্যান্ডার্ড রুটের সেট।

LearningStandardSetRoot

বেছে নেওয়া লার্নিং স্ট্যান্ডার্ড সেটের রুটকে দেখায়। Classroom UI-তে স্ট্রিম আইটেমে লার্নিং গোল সেট করার সময় বেছে নেওয়া রুট থেকে তৈরি হওয়া আইটেম দেখানো হবে।

JSON উপস্থাপনা 
{
  "caseGuid": {
    object (CaseGuid)
  },
  "documentTitle": string,
  "standardTitle": string,
  "sourceDataAvailabilityStatus": enum (LearningStandardAvailabilityState)
}
ফিল্ড
caseGuid

object (CaseGuid)

প্রয়োজনীয়। লার্নিং স্ট্যান্ডার্ড সেট রুটের জন্য Satchel Rosetta Exchange GUID।
documentTitle

string

শুধুমাত্র আউটপুট। লার্নিং স্ট্যান্ডার্ড সেট রুটের ডকুমেন্ট টাইটেল।
standardTitle

string

শুধুমাত্র আউটপুট। লার্নিং স্ট্যান্ডার্ড সেট রুটের শীর্ষক।
sourceDataAvailabilityStatus

enum (LearningStandardAvailabilityState)

শুধুমাত্র আউটপুট। লার্নিং স্ট্যান্ডার্ড সেট রুটের উপলভ্যতা সংক্রান্ত স্ট্যাটাস। লার্নিং স্ট্যান্ডার্ড সেট রুট সোর্স থেকে মুছে ফেলা হয়েছে কিনা তা নির্ধারণ করতে এটি ব্যবহার করুন।

পদ্ধতি

checkAddOnCreationEligibility
(deprecated)

 কোনও ব্যবহারকারী নির্দিষ্ট কোর্সে অ্যাড-অন অ্যাটাচমেন্ট তৈরি করার উপযুক্ত কিনা তা জানায়।

checkGradingPeriodsSetupEligibility
(deprecated)

 কোনও ব্যবহারকারী নির্দিষ্ট কোর্সে GradingPeriodSettings আপডেট করার উপযুক্ত কিনা তা দেখায়।

create

 কোর্স তৈরি করে।

delete

 কোর্স মুছে দেয়।

get

 একটি কোর্স ফেরত দেয়।

getGradingPeriodSettings

 কোনও কোর্সে গ্রেডিং পিরিয়ড সেটিংস দেখায়।

list

 অনুরোধকারী ব্যবহারকারীকে দেখার অনুমতি দেওয়া হয়েছে এমন কোর্সের একটি তালিকা প্রদান করে, যা অনুরোধের সাথে মেলে এমন কোর্সের মধ্যে সীমাবদ্ধ।

patch

 কোর্সের এক বা একাধিক ফিল্ড আপডেট করে।

update

 কোর্স আপডেট করে।

updateGradingPeriodSettings

 কোনও কোর্সের গ্রেডিং পিরিয়ড সেটিংস আপডেট করে।