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)
  }
}
ক্ষেত্র
id

string

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

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

কোর্স আপডেট মাস্কে এই ক্ষেত্রটি নির্দিষ্ট করলে একটি ত্রুটি দেখা দেয়।

name

string

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

section

string

কোর্সের অংশ। উদাহরণস্বরূপ, "পিরিয়ড ২"। যদি সেট করা থাকে, তাহলে এই ক্ষেত্রটি অবশ্যই একটি বৈধ UTF-8 স্ট্রিং হতে হবে এবং ২৮০০ অক্ষরের বেশি হবে না।

descriptionHeading

string

বর্ণনার জন্য ঐচ্ছিক শিরোনাম। উদাহরণস্বরূপ, "দশম শ্রেণীর জীববিজ্ঞানে স্বাগতম।" যদি সেট করা থাকে, তাহলে এই ক্ষেত্রটি অবশ্যই একটি বৈধ UTF-8 স্ট্রিং হতে হবে এবং 3600 অক্ষরের বেশি হবে না।

description

string

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

room

string

ঐচ্ছিক রুমের অবস্থান। উদাহরণস্বরূপ, "301"। যদি সেট করা থাকে, তাহলে এই ক্ষেত্রটি অবশ্যই একটি বৈধ UTF-8 স্ট্রিং হতে হবে এবং 650 অক্ষরের বেশি হবে না।

ownerId

string

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

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

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

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

creationTime

string ( Timestamp format)

কোর্স তৈরির সময়। কোর্স আপডেট মাস্কে এই ক্ষেত্রটি নির্দিষ্ট করলে একটি ত্রুটি দেখা দেয়।

কেবল পঠনযোগ্য।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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 )

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

কেবল পঠনযোগ্য।

কোর্সস্টেট

একটি কোর্স কোন কোন পরিস্থিতিতে থাকতে পারে?

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

কোর্সমেটেরিয়ালসেট

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

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

string

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

materials[]

object ( CourseMaterial )

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

কোর্স উপাদান

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

JSON উপস্থাপনা 
{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড 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

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