REST Resource: courses.courseWork

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

কোর্সের শিক্ষার্থীদের জন্য একজন শিক্ষক কর্তৃক তৈরি কোর্সওয়ার্ক।

JSON উপস্থাপনা 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
ক্ষেত্র
courseId

string

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

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

id

string

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

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

title

string

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

description

string

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

materials[]

object ( Material )

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

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

state

enum ( CourseWorkState )

এই কোর্সওয়ার্কের অবস্থা। যদি নির্দিষ্ট করে দেওয়া না থাকে, তাহলে ডিফল্ট অবস্থা হলো 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" ।

dueDate

object ( Date )

এই কোর্সের কাজ জমা দেওয়ার শেষ তারিখ (ইউটিসি সময় অনুযায়ী), যা ঐচ্ছিক। যদি dueTime উল্লেখ করা থাকে, তবে এই তারিখটিও অবশ্যই উল্লেখ করতে হবে।

dueTime

object ( TimeOfDay )

এই কোর্সের কাজ জমা দেওয়ার ঐচ্ছিক সময় (ইউটিসি অনুযায়ী)। যদি dueDate উল্লেখ করা থাকে, তবে এটি অবশ্যই উল্লেখ করতে হবে।

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" ।

maxPoints

number

এই কোর্সওয়ার্কের জন্য সর্বোচ্চ গ্রেড। গ্রেড শূন্য বা অনির্দিষ্ট হলে, এই অ্যাসাইনমেন্টটি গ্রেডবিহীন বলে গণ্য হবে। এটি অবশ্যই একটি অঋণাত্মক পূর্ণসংখ্যা হতে হবে।

workType

enum ( CourseWorkType )

এই কোর্সওয়ার্কের ধরণ।

কোর্সওয়ার্ক তৈরি করার সময় এর ধরন নির্ধারণ করা হয় এবং তা পরিবর্তন করা যায় না।

associatedWithDeveloper

boolean

এই কোর্স ওয়ার্ক আইটেমটি অনুরোধকারী ডেভেলপার কনসোল প্রজেক্টের সাথে সংশ্লিষ্ট কিনা।

আরও বিস্তারিত জানতে courseWork.create দেখুন।

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

assigneeMode

enum ( AssigneeMode )

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

individualStudentsOptions

object ( IndividualStudentsOptions )

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

submissionModificationMode

enum ( SubmissionModificationMode )

শিক্ষার্থীরা কখন তাদের জমা দেওয়া ফাইল পরিবর্তন করতে পারবে, তা নির্ধারণ করার সেটিং। যদি নির্দিষ্ট করা না থাকে, তাহলে ডিফল্ট মান হবে MODIFIABLE_UNTIL_TURNED_IN ।

creatorUserId

string

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

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

topicId

string

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

gradeCategory

object ( GradeCategory )

যে বিভাগে এই কোর্সওয়ার্কের গ্রেড অন্তর্ভুক্ত হবে। শুধুমাত্র তখনই প্রদর্শিত হবে যখন কোর্সওয়ার্কের জন্য কোনো বিভাগ নির্বাচন করা হয়েছে। সামগ্রিক গ্রেড গণনার ক্ষেত্রে এটি ব্যবহার করা যেতে পারে।

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

previewVersion

enum ( PreviewVersion )

শুধুমাত্র আউটপুট। এই রিসোর্সটি পুনরুদ্ধার করতে ব্যবহৃত এপিআই-এর প্রিভিউ সংস্করণ।

learningGoals[]

object ( LearningGoal )

ঐচ্ছিক।

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

ইউনিয়ন ফিল্ডের details । কোর্সওয়ার্কের কোনো একটি নির্দিষ্ট ধরনের জন্য প্রযোজ্য অতিরিক্ত বিবরণ। details নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
assignment

object ( Assignment )

অ্যাসাইনমেন্টের বিবরণ। এটি শুধুমাত্র তখনই পূরণ করা হয় যখন workType ASSIGNMENT হয়।

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

multipleChoiceQuestion

object ( MultipleChoiceQuestion )

বহুনির্বাচনী প্রশ্নের বিবরণ। রিড অপারেশনের জন্য, এই ফিল্ডটি শুধুমাত্র তখনই পূরণ করা হয় যখন workType MULTIPLE_CHOICE_QUESTION হয়। রাইট অপারেশনের জন্য, MULTIPLE_CHOICE_QUESTION workType দিয়ে কোর্স ওয়ার্ক তৈরি করার সময় এই ফিল্ডটি অবশ্যই নির্দিষ্ট করতে হবে, এবং অন্যথায় এটি সেট করা যাবে না।

gradingPeriodId

string

কোর্সওয়ার্কটির সাথে সংশ্লিষ্ট মূল্যায়ন পর্বের শনাক্তকারী।

  • তৈরির সময়, যদি নির্দিষ্ট করা না থাকে, তাহলে গ্রেডিং পিরিয়ড আইডি dueDate (অথবা নির্ধারিত dueDate না থাকলে scheduledTime সময়ের) উপর ভিত্তি করে সেট করা হবে।
  • কোনো গ্রেডিং পিরিয়ডের সাথে সম্পর্ক না বোঝাতে, এই ফিল্ডটিকে একটি খালি স্ট্রিং ("") দিয়ে সেট করুন।
  • নির্দিষ্ট করা হলে, তা অবশ্যই কোর্সের একটি বিদ্যমান গ্রেডিং পিরিয়ড আইডির সাথে মিলতে হবে।

কোর্সওয়ার্কস্টেট

পাঠ্যক্রমের সম্ভাব্য অবস্থাগুলো।

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

জমা পরিবর্তন মোড

শিক্ষার্থীদের জমা দেওয়া কাজের জন্য সম্ভাব্য পরিবর্তন পদ্ধতিসমূহ।

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

অ্যাসাইনমেন্ট

নির্ধারিত কাজগুলোর জন্য অতিরিক্ত বিবরণ।

JSON উপস্থাপনা 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
ক্ষেত্র
studentWorkFolder

object ( DriveFolder )

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

বহুনির্বাচনী প্রশ্ন

বহুনির্বাচনী প্রশ্নের জন্য অতিরিক্ত বিবরণ।

JSON উপস্থাপনা 
{
  "choices": [
    string
  ]
}
ক্ষেত্র
choices[]

string

সম্ভাব্য পছন্দগুলো।

পদ্ধতি

create

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

delete

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

get

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

getAddOnContext

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

list

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

modifyAssignees

 একটি কোর্সওয়ার্কের অ্যাসাইনি মোড এবং অপশন পরিবর্তন করে।

patch

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