REST Resource: courses.courseWork

রিসোর্স: 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

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

শুধুমাত্র পড়তে পারবেন।
title

string

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

string

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

object (Material)

অতিরিক্ত মেটেরিয়াল।

CourseWork-এ ২০টির বেশি মেটেরিয়াল আইটেম থাকলে চলবে না।
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)

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

object (TimeOfDay)

UTC অনুযায়ী দিনের ঐচ্ছিক সময়, এই কোর্স ওয়ার্ক জমা দেওয়ার সময়সীমা। 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

এই কোর্স ওয়ার্ক আইটেমটি অনুরোধকারী Developer Console প্রোজেক্টের সাথে যুক্ত কিনা।

আরও বিবরণের জন্য 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)

ঐচ্ছিক।

এই কোর্স ওয়ার্কের সাথে অ্যাটাচ করা যেকোনও শেখার লক্ষ্যের রেফারেন্স। CourseWork-এ সর্বাধিক ১০টি শেখার লক্ষ্য থাকতে পারে। উপযুক্ত previewVersion সেট করা থাকলে তবেই এই ফিল্ড পূরণ করা হয়।
অতিরিক্ত বিবরণ যা কোনও নির্দিষ্ট ধরনের কোর্স ওয়ার্কের জন্য প্রযোজ্য। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
assignment

object (Assignment)

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

শুধুমাত্র পড়তে পারবেন।
multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

string

কোর্সওয়ার্কের সাথে যুক্ত গ্রেডিং পিরিয়ডের শনাক্তকারী।

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

CourseWorkState

কোর্স ওয়ার্কের সম্ভাব্য স্ট্যাটাস।

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

SubmissionModificationMode

স্টুডেন্টদের জমা দেওয়া অ্যাসাইনমেন্টের জন্য সম্ভাব্য পরিবর্তন মোড।

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

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

অ্যাসাইনমেন্টের জন্য অতিরিক্ত বিবরণ।

JSON উপস্থাপনা 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
ফিল্ড
studentWorkFolder

object (DriveFolder)

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

MultipleChoiceQuestion

একাধিক পছন্দের প্রশ্নের জন্য অতিরিক্ত বিবরণ।

JSON উপস্থাপনা 
{
  "choices": [
    string
  ]
}
ফিল্ড
choices[]

string

সম্ভাব্য পছন্দ।

পদ্ধতি

create

 কোর্স ওয়ার্ক তৈরি করে।

delete

 কোর্স ওয়ার্ক মুছে দেয়।

get

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

getAddOnContext

 নির্দিষ্ট পোস্টের প্রসঙ্গে Classroom অ্যাড-অনের জন্য মেটাডেটা পায়।

list

 অনুরোধকারীকে দেখার অনুমতি দেওয়া হয়েছে এমন কোর্স ওয়ার্কের তালিকা দেখায়।

modifyAssignees

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

patch

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