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 এখনও ক্লাসরুম দ্বারা বরাদ্দ করা হয়েছে এবং কোর্সটি তৈরি হওয়ার পরে আপডেট করা যাবে না।

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

name

string

কোর্সের নাম। যেমন, "দশম শ্রেণির জীববিজ্ঞান"। নাম আবশ্যক. এটি অবশ্যই 1 থেকে 750 অক্ষরের মধ্যে হতে হবে এবং একটি বৈধ UTF-8 স্ট্রিং হতে হবে৷

section

string

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

descriptionHeading

string

বর্ণনার জন্য ঐচ্ছিক শিরোনাম। উদাহরণস্বরূপ, "10 তম গ্রেড জীববিজ্ঞানে স্বাগতম।" সেট করা থাকলে, এই ক্ষেত্রটি অবশ্যই একটি বৈধ 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)

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

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

updateTime

string ( Timestamp format)

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

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

enrollmentCode

string

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

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

courseState

enum ( CourseState )

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

teacherGroupEmail

string

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

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

courseGroupEmail

string

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

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

teacherFolder

object ( DriveFolder )

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

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

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

courseMaterialSets[]
(deprecated)

object ( CourseMaterialSet )

এই কোর্সের "সম্পর্কে" পৃষ্ঠায় প্রদর্শিত উপকরণগুলির সেট৷

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

guardiansEnabled

boolean

এই কোর্সের জন্য অভিভাবক বিজ্ঞপ্তিগুলি সক্ষম কিনা।

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

calendarId

string

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

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

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

gradebookSettings

object ( GradebookSettings )

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

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

কোর্স স্টেট

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

Enums
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 প্রতিনিধিত্ব
{

  // 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 )

Google ফর্ম সংযুক্তি.

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

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

JSON প্রতিনিধিত্ব
{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}
ক্ষেত্র
calculationType

enum ( CalculationType )

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

displaySetting

enum ( DisplaySetting )

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

gradeCategories[]

object ( GradeCategory )

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

ক্যালকুলেশন টাইপ

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

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

প্রদর্শন বিন্যাস

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

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

পদ্ধতি

checkAddOnCreationEligibility

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

checkGradingPeriodsSetupEligibility

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

create

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

delete

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

get

 একটি কোর্স প্রদান করে।

getGradingPeriodSettings

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

list

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

patch

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

update

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

updateGradingPeriodSettings

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