REST Resource: courses.courseWorkMaterials

উৎস: কোর্সওয়ার্ক উপকরণ

কোর্সের শিক্ষার্থীদের জন্য একজন শিক্ষক কর্তৃক তৈরি পাঠ্য উপকরণ।

JSON উপস্থাপনা
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkMaterialState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string,
  "topicId": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
ক্ষেত্র
courseId

string

কোর্সের শনাক্তকারী।

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

id

string

এই কোর্সওয়ার্ক উপকরণের জন্য শ্রেণিকক্ষে নির্ধারিত শনাক্তকারী, যা প্রতিটি কোর্সের জন্য অনন্য।

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

title

string

এই কোর্সওয়ার্ক উপকরণের শিরোনাম। শিরোনামটি অবশ্যই ১ থেকে ৩০০০ অক্ষরের একটি বৈধ UTF-8 স্ট্রিং হতে হবে।

description

string

এই কোর্সওয়ার্ক উপকরণের ঐচ্ছিক বিবরণ। লেখাটি অবশ্যই একটি বৈধ UTF-8 স্ট্রিং হতে হবে এবং এতে ৩০,০০০-এর বেশি অক্ষর থাকবে না।

materials[]

object ( Material )

অতিরিক্ত উপকরণ।

একটি কোর্সওয়ার্ক সামগ্রীতে ২০টির বেশি উপাদান থাকতে পারবে না।

state

enum ( CourseWorkMaterialState )

এই কোর্সওয়ার্ক উপকরণের অবস্থা। যদি নির্দিষ্ট করা না থাকে, তাহলে ডিফল্ট অবস্থা হলো DRAFT )।

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"

scheduledTime

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"

assigneeMode

enum ( AssigneeMode )

কোর্সওয়ার্ক উপকরণের অর্পণকারী মোড। যদি নির্দিষ্ট না করা হয়, তাহলে ডিফল্ট মান হবে ALL_STUDENTS )।

individualStudentsOptions

object ( IndividualStudentsOptions )

যেসব ছাত্রছাত্রীর কোর্সওয়ার্ক সামগ্রীতে প্রবেশাধিকার আছে, তাদের শনাক্তকারী। এই ফিল্ডটি শুধুমাত্র তখনই সেট করা হয় যখন assigneeMode মান INDIVIDUAL_STUDENTS হয়। যদি assigneeMode INDIVIDUAL_STUDENTS হয়, তাহলে শুধুমাত্র এই ফিল্ডে উল্লেখিত ছাত্রছাত্রীরাই কোর্সওয়ার্ক সামগ্রী দেখতে পারবে।

creatorUserId

string

কোর্স ওয়ার্ক সামগ্রী তৈরি করা ব্যবহারকারীর শনাক্তকারী।

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

topicId

string

এই কোর্সওয়ার্ক উপাদানটি যে বিষয়ের সাথে সম্পর্কিত, তার শনাক্তকারী। এটি অবশ্যই কোর্সের একটি বিদ্যমান বিষয়ের সাথে মিলতে হবে।

learningGoals[]

object ( LearningGoal )

ঐচ্ছিক।

এই কোর্সওয়ার্ক উপকরণের সাথে সংযুক্ত যেকোনো শিখন লক্ষ্যের উল্লেখ। কোর্সওয়ার্ক উপকরণে সর্বাধিক ১০টি শিখন লক্ষ্য থাকতে পারে। এই ক্ষেত্রটি কেবল তখনই পূরণ করা হয় যখন উপযুক্ত previewVersion সেট করা থাকে।

কোর্সওয়ার্ক উপকরণ অবস্থা

পাঠ্যক্রমের উপকরণের সম্ভাব্য অবস্থা

এনাম
COURSEWORK_MATERIAL_STATE_UNSPECIFIED কোনো অবস্থা নির্দিষ্ট করা হয়নি। এটি কখনো ফেরত দেওয়া হয় না।
PUBLISHED প্রকাশিত কোর্সওয়ার্ক উপকরণের অবস্থা। এটিই ডিফল্ট অবস্থা।
DRAFT যে কোর্সওয়ার্ক উপাদান এখনও প্রকাশিত হয়নি, তার অবস্থা। এই অবস্থায় থাকা কোর্সওয়ার্ক উপাদান শুধুমাত্র কোর্স শিক্ষক এবং ডোমেইন প্রশাসকগণ দেখতে পারেন।
DELETED প্রকাশিত কিন্তু বর্তমানে মুছে ফেলা কোর্সওয়ার্ক উপকরণের অবস্থা। এই অবস্থায় থাকা কোর্সওয়ার্ক উপকরণ শুধুমাত্র কোর্স শিক্ষক এবং ডোমেইন প্রশাসকগণ দেখতে পান। কিছু সময় পর এই অবস্থায় থাকা কোর্সওয়ার্ক উপকরণ মুছে ফেলা হয়।

পদ্ধতি

create

পাঠ্যক্রমের উপকরণ তৈরি করে।

delete

কোর্সওয়ার্কের একটি উপাদান মুছে দেয়।

get

কোর্সওয়ার্কের উপকরণ ফেরত দেয়।

getAddOnContext

একটি নির্দিষ্ট পোস্টের প্রেক্ষাপটে ক্লাসরুম অ্যাড-অনগুলির মেটাডেটা সংগ্রহ করে।

list

কোর্সওয়ার্ক উপকরণের একটি তালিকা ফেরত দেয়, যা অনুরোধকারী দেখার অনুমতিপ্রাপ্ত।

patch

কোর্সওয়ার্ক উপকরণের এক বা একাধিক ফিল্ড আপডেট করে।