REST Resource: courses

উৎস: কোর্স

শ্রেণীকক্ষে একটি কোর্স।

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,
  "levels": string
}
ক্ষেত্র
id

string

ক্লাসরুম কর্তৃক এই কোর্সের জন্য নির্ধারিত শনাক্তকারী।

creating a course সময়, আপনি চাইলে একটি সংশ্লিষ্ট অ্যালিয়াস তৈরির জন্য অনুরোধে এই আইডেন্টিফায়ারটিকে একটি alias string এ সেট করতে পারেন। 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 এই ফিল্ডটি নির্দিষ্ট করতে পারেন। অন্যান্য ক্ষেত্রে, এটি শুধুমাত্র পঠনযোগ্য (read-only)।

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

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

শুধুমাত্র পঠনযোগ্য।

courseGroupEmail

string

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

শুধুমাত্র পঠনযোগ্য।

teacherFolder

object ( DriveFolder )

একটি ড্রাইভ ফোল্ডার সম্পর্কিত তথ্য, যা কোর্সের সকল শিক্ষকের সাথে শেয়ার করা হয়।

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

শুধুমাত্র পঠনযোগ্য।

courseMaterialSets[]
(deprecated)

object ( CourseMaterialSet )

এই কোর্সের "আমাদের সম্পর্কে" পাতায় প্রদর্শিত উপকরণসমূহ।

শুধুমাত্র পঠনযোগ্য।

guardiansEnabled

boolean

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

শুধুমাত্র পঠনযোগ্য।

calendarId

string

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

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

শুধুমাত্র পঠনযোগ্য।

gradebookSettings

object ( GradebookSettings )

গ্রেডবুক সেটিংস, যা নির্ধারণ করে দেয় যে একটি কোর্সে একজন শিক্ষার্থীর সামগ্রিক গ্রেড কীভাবে গণনা করা হবে এবং কাকে তা দেখানো হবে।

শুধুমাত্র পঠনযোগ্য।

subject

string

ঐচ্ছিক। পাঠ্যক্রমের বিষয়।

levels

string

ঐচ্ছিক। কোর্সের স্তরসমূহ। উদাহরণ: "9th grade", "Middle school", "4th - 5th", "K-2", "3000"। যদি সেট করা হয়, এই ফিল্ডটি অবশ্যই একটি বৈধ UTF-8 স্ট্রিং হতে হবে এবং এর অক্ষর সংখ্যা ১০০০-এর কম হতে হবে।

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

কোর্সস্টেট

একটি কোর্স যেসব সম্ভাব্য রাজ্যে থাকতে পারে।

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

কোর্স উপকরণ সেট

কোর্সের "আমাদের সম্পর্কে" পাতায় প্রদর্শিত উপকরণসমূহের একটি সেট। এই উপকরণগুলোর মধ্যে একটি সিলেবাস, সময়সূচী বা সামগ্রিকভাবে কোর্সটি সম্পর্কিত অন্যান্য পটভূমিমূলক তথ্য অন্তর্ভুক্ত থাকতে পারে।

JSON উপস্থাপনা 
{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}
ক্ষেত্র
title

string

এই সেটের শিরোনাম।

materials[]

object ( CourseMaterial )

এই সেটের সাথে সংযুক্ত উপকরণসমূহ।

পাঠ্যক্রম সামগ্রী

কোনো পাঠ্য উপকরণ সেটের অংশ হিসেবে কোর্সের সাথে সংযুক্ত একটি উপকরণ।

JSON উপস্থাপনা 
{

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

object ( DriveFile )

গুগল ড্রাইভ ফাইল সংযুক্তি।

youTubeVideo

object ( YouTubeVideo )

ইউটিউব ভিডিও সংযুক্তি।

form

object ( Form )

গুগল ফর্ম সংযুক্তি।

গ্রেডবুক সেটিংস

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

JSON উপস্থাপনা 
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
ক্ষেত্র
calculationType

enum ( CalculationType )

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

displaySetting

enum ( DisplaySetting )

কারা সামগ্রিক গ্রেড দেখতে পারবে তা নির্দেশ করে।

gradeCategories[]

object ( GradeCategory )

কোর্সের পাঠ্যক্রমের জন্য উপলব্ধ গ্রেড বিভাগসমূহ।

গণনার ধরণ

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

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

ডিসপ্লেসেটিং

সামগ্রিক গ্রেড প্রদর্শনের সম্ভাব্য সেটিংস।

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

পদ্ধতি

checkAddOnCreationEligibility
(deprecated)

 কোনো ব্যবহারকারী প্রদত্ত কোর্সে অতিরিক্ত সংযুক্তি তৈরি করার যোগ্য কিনা তা জানায়।

checkGradingPeriodsSetupEligibility
(deprecated)

 কোনো ব্যবহারকারী একটি নির্দিষ্ট কোর্সে GradingPeriodSettings আপডেট করার যোগ্য কিনা তা ফেরত দেয়।

create

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

delete

 একটি কোর্স মুছে ফেলে।

get

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

getGradingPeriodSettings

 একটি কোর্সের গ্রেডিং পিরিয়ড সেটিংস ফেরত দেয়।

list

 অনুরোধকারী ব্যবহারকারী যে কোর্সগুলো দেখার অনুমতি রাখেন, তার একটি তালিকা ফেরত দেয়, যা শুধুমাত্র অনুরোধের সাথে মেলে এমন কোর্সগুলোর মধ্যেই সীমাবদ্ধ থাকে।

patch

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

update

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

updateGradingPeriodSettings

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