REST Resource: courses.courseWork.studentSubmissions

রিসোর্স: StudentSubmission

কোর্স ওয়ার্কের জন্য স্টুডেন্টের জমা দেওয়া কাজ।

CourseWorkটি আইটেম তৈরি করা হলে StudentSubmissionটি আইটেম জেনারেট করা হয়।

শিক্ষার্থীর জমা দেওয়া অ্যাসাইনমেন্ট যা কখনও অ্যাক্সেস করা হয়নি (যেমন, state = নতুন) সেটির তৈরি বা আপডেট করার সময় নাও থাকতে পারে।

JSON উপস্থাপনা 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
ফিল্ড
courseId

string

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

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

string

কোর্স ওয়ার্কের জন্য শনাক্তকারী যার সাথে এটি সম্পর্কিত।

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

string

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

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

string

এই জমা দেওয়া আইটেমের মালিক যে স্টুডেন্ট তার শনাক্তকারী।

শুধুমাত্র পড়তে পারবেন।
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"।
state

enum (SubmissionState)

এই জমা দেওয়ার স্ট্যাটাস।

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

boolean

এই জমা দেওয়া দেরিতে হয়েছে কিনা।

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

number

ঐচ্ছিক বাকি থাকা গ্রেড। আনসেট করা থাকলে, কোনও গ্রেড সেট করা হয়নি। এই ভ্যালু অবশ্যই নেগেটিভ নয় এমন হতে হবে। দশমিক (অর্থাৎ, পূর্ণসংখ্যা নয়) ভ্যালু ব্যবহার করা যাবে, তবে তা দুই দশমিক স্থান পর্যন্ত রাউন্ড করা হয়।

এটি শুধুমাত্র কোর্সের শিক্ষক দেখতে ও পরিবর্তন করতে পারবেন।
assignedGrade

number

ঐচ্ছিক গ্রেড। আনসেট করা থাকলে, কোনও গ্রেড সেট করা হয়নি। এই ভ্যালু অবশ্যই নেগেটিভ নয় এমন হতে হবে। দশমিক (অর্থাৎ, পূর্ণসংখ্যা নয়) ভ্যালু অনুমোদিত, তবে তা দুই দশমিক স্থান পর্যন্ত রাউন্ড করা হয়।

শুধুমাত্র কোর্সের শিক্ষক এটি পরিবর্তন করতে পারবেন।
rubricId

string

শুধুমাত্র আউটপুট। বর্তমানে এই কোর্স ওয়ার্কের সাথে অ্যাটাচ করা এবং এই স্টুডেন্ট জমা দেওয়ার গ্রেডিংয়ের জন্য ব্যবহৃত রুব্রিকের শনাক্তকারী।

কোনও রুব্রিক না থাকলে এই আইডি খালি থাকে। এই আইডি বর্তমানে অ্যাক্টিভ রুব্রিক দেখায়; শিক্ষক রুব্রিক মুছে দিয়ে আবার তৈরি করলে এটি পরিবর্তিত হয়।

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

draftRubricGrades

map (key: string, value: object (RubricGrade))

রুব্রিকের মাপকাঠির উপর ভিত্তি করে রুব্রিক গ্রেড বাকি আছে।

এই কোর্স ওয়ার্কে কোনও রুব্রিক অ্যাটাচ করা না থাকলে অথবা রুব্রিক অ্যাটাচ করা থাকলেও কোনও মাপকাঠিতে গ্রেড সেট করা না থাকলে, এই ম্যাপ খালি থাকে। যেসব গ্রেড সেট করা হয়েছে শুধুমাত্র সেগুলির জন্যই এন্ট্রি দেখানো হয়। কী: রুব্রিকের নির্ণায়ক আইডি।

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

"key": valueটি পেয়ারের তালিকা সহ অবজেক্ট। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }।
assignedRubricGrades

map (key: string, value: object (RubricGrade))

রুব্রিকের মাপকাঠির উপর ভিত্তি করে রুব্রিক গ্রেড অ্যাসাইন করা হয়েছে।

এই কোর্স ওয়ার্কে কোনও রুব্রিক অ্যাটাচ করা না থাকলে অথবা রুব্রিক অ্যাটাচ করা থাকলেও কোনও মাপকাঠিতে গ্রেড সেট করা না থাকলে, এই ম্যাপ খালি থাকে। যেসব গ্রেড সেট করা হয়েছে শুধুমাত্র সেগুলির জন্যই এন্ট্রি পপুলেট করা হয়। কী: রুব্রিকের নির্ণায়ক ID।

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

"key": valueটি পেয়ারের তালিকা সহ অবজেক্ট। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }।
courseWorkType

enum (CourseWorkType)

এই জমা দেওয়া অ্যাসাইনমেন্টটি যে ধরনের কোর্স ওয়ার্কের জন্য।

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

boolean

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

আরও বিবরণের জন্য courseWork.create দেখুন।

শুধুমাত্র পড়তে পারবেন।
submissionHistory[]

object (SubmissionHistory)

জমা দেওয়ার ইতিহাস (এর মধ্যে স্ট্যাটাস ও গ্রেডের ইতিহাস অন্তর্ভুক্ত)।

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

enum (PreviewVersion)

শুধুমাত্র আউটপুট। API-এর প্রিভিউ ভার্সন। প্রিভিউ প্রোগ্রামে ডেভেলপারদের জন্য উপলভ্য নতুন API ক্ষমতা অ্যাক্সেস করার জন্য এটি সেট করতে হবে।
জমা দেওয়া কন্টেন্ট। নির্দিষ্ট ধরনটি course_work_type-এর মানের উপর নির্ভর করে। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
assignmentSubmission

object (AssignmentSubmission)

courseWorkType, ASSIGNMENT হলে জমা দেওয়া কন্টেন্ট।

studentSubmissions.modifyAttachments ব্যবহার করে স্টুডেন্টরা এই কন্টেন্ট পরিবর্তন করতে পারবে।
shortAnswerSubmission

object (ShortAnswerSubmission)

courseWorkType-এর মান SHORT_ANSWER_QUESTION হলে জমা দেওয়া কন্টেন্ট।
multipleChoiceSubmission

object (MultipleChoiceSubmission)

courseWorkType-এর ধরন MULTIPLE_CHOICE_QUESTION হলে জমা দেওয়া কন্টেন্ট।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

RubricGrade

স্টুডেন্টের জমা দেওয়া অ্যাসাইনমেন্টের জন্য একটি রুব্রিক গ্রেড সেট করা হয়েছে। প্রতিটি রুব্রিকের মাপকাঠিতে সর্বাধিক একটি এন্ট্রি থাকে।

JSON উপস্থাপনা 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
ফিল্ড
criterionId

string

ঐচ্ছিক। নির্ণায়ক ID.
levelId

string

ঐচ্ছিক। বেছে নেওয়া লেভেলের ঐচ্ছিক লেভেল আইডি। খালি থাকলে, কোনও লেভেল বেছে নেওয়া হয়নি।
points

number

ঐচ্ছিক। এই মাপকাঠির জন্য অ্যাসাইন করা ঐচ্ছিক পয়েন্ট, সাধারণত লেভেলের উপর ভিত্তি করে। লেভেলে পয়েন্ট থাকতেও পারে আবার নাও থাকতে পারে। আনসেট করা থাকলে, এই মাপকাঠির জন্য কোনও পয়েন্ট সেট করা হয়নি।

AssignmentSubmission

অ্যাসাইনমেন্টের জন্য স্টুডেন্টের কাজ।

JSON উপস্থাপনা 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
ফিল্ড
attachments[]

object (Attachment)

স্টুডেন্টের যোগ করা অ্যাটাচমেন্ট। স্টুডেন্ট Classroom-এ অ্যাসাইনমেন্ট অ্যাক্সেস না করে থাকলে, STUDENT_COPY শেয়ার মোড সহ মেটেরিয়ালের সাথে সম্পর্কিত Drive ফাইল এখনও নাও থাকতে পারে।

অনুরোধকারী ব্যবহারকারীর অ্যাক্সেস করার অনুমতি থাকলে তবেই কিছু অ্যাটাচমেন্ট মেটাডেটা পপুলেট করা হয়। Identifier এবং alternateLink ফিল্ড সবসময় উপলভ্য থাকে, তবে অন্যান্য ফিল্ড (যেমন, title) উপলভ্য নাও থাকতে পারে।

অ্যাটাচমেন্ট

শিক্ষার্থীর অ্যাসাইনমেন্টের কাজে অ্যাটাচমেন্ট যোগ করা হয়েছে।

অ্যাটাচমেন্ট তৈরি করার সময়, form ফিল্ড সেট করা যাবে না।

JSON উপস্থাপনা 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
ফিল্ড
অ্যাটাচমেন্ট ডেটা। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
driveFile

object (DriveFile)

Google Drive ফাইল অ্যাটাচমেন্ট।
youTubeVideo

object (YouTubeVideo)

YouTube ভিডিও অ্যাটাচমেন্ট।
form

object (Form)

Google Forms অ্যাটাচমেন্ট।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

ShortAnswerSubmission

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

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

string

সংক্ষিপ্ত উত্তরধর্মী প্রশ্নের জন্য স্টুডেন্টের উত্তর।

MultipleChoiceSubmission

একাধিক পছন্দের প্রশ্নের জন্য স্টুডেন্টের কাজ।

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

string

স্টুডেন্টের বেছে নেওয়া পছন্দ।

SubmissionHistory

জমা দেওয়ার ইতিহাস। বর্তমানে এর মধ্যে স্ট্যাটাস ও গ্রেডের ইতিহাস অন্তর্ভুক্ত।

JSON উপস্থাপনা 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
ফিল্ড
SubmissionHistory-এর ধরন, StateHistory, GradeHistory-এর মধ্যে যেকোনও একটি হতে পারে। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
stateHistory

object (StateHistory)

জমা দেওয়ার স্ট্যাটাস সংক্রান্ত ইতিহাস, যদি থাকে।
gradeHistory

object (GradeHistory)

অ্যাসাইনমেন্ট জমা দেওয়ার গ্রেড ইতিহাস সংক্রান্ত তথ্য, যদি থাকে।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

StateHistory

এই জমা দেওয়া প্রতিটি স্ট্যাটাসের ইতিহাস।

JSON উপস্থাপনা 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
ফিল্ড
state

enum (State)

ওয়ার্কফ্লো পাইপলাইন স্টেজ।
stateTimestamp

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

string

যে শিক্ষক বা শিক্ষার্থী পরিবর্তন করেছেন।

রাজ্য

জমা দেওয়ার সম্ভাব্য স্ট্যাটাস।

Enums
STATE_UNSPECIFIED কোনও রাজ্য নির্দিষ্ট করা নেই। এটি কখনই ফেরত দেওয়া উচিত নয়।
CREATED জমা দেওয়ার প্রক্রিয়া তৈরি করা হয়েছে।
TURNED_IN শিক্ষার্থী অ্যাসাইন করা ডকুমেন্ট জমা দিয়েছে, যা টেমপ্লেট হতেও পারে আবার নাও হতে পারে।
RETURNED শিক্ষক অ্যাসাইন করা ডকুমেন্ট স্টুডেন্টকে ফেরত দিয়েছেন।
RECLAIMED_BY_STUDENT ছাত্রটি অ্যাসাইন করা ডকুমেন্ট জমা দেয় এবং তারপরে অ্যাসাইনমেন্ট "জমা দেওয়া বাতিল" করার বিকল্প বেছে নেয়, যার ফলে ছাত্রটি আবার মালিক হিসেবে নিয়ন্ত্রণ ফিরে পায়।
STUDENT_EDITED_AFTER_TURN_IN জমা দেওয়ার পরে স্টুডেন্ট তার জমা দেওয়া অ্যাসাইনমেন্ট এডিট করেছে। বর্তমানে, শুধুমাত্র প্রশ্নের ক্ষেত্রে ব্যবহার করা হয়, যখন স্টুডেন্ট তার উত্তর এডিট করে।

GradeHistory

এই জমা দেওয়া অ্যাসাইনমেন্টের প্রতিটি গ্রেডের ইতিহাস।

JSON উপস্থাপনা 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
ফিল্ড
pointsEarned

number

জমা দেওয়া গ্রেডের ইতিহাসে এই সময়ে গ্রেডের লব।
maxPoints

number

জমা দেওয়া গ্রেডের ইতিহাসে এই সময়ে গ্রেডের হর।
gradeTimestamp

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

string

যে শিক্ষক গ্রেড পরিবর্তন করেছেন।
gradeChangeType

enum (GradeChangeType)

জমা দেওয়ার গ্রেড ইতিহাসে এই সময়ে গ্রেডের ধরন পরিবর্তন।

GradeChangeType

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

Enums
UNKNOWN_GRADE_CHANGE_TYPE গ্রেড পরিবর্তনের কোনও ধরন নির্দিষ্ট করা নেই। এটি কখনই ফেরত দেওয়া উচিত নয়।
DRAFT_GRADE_POINTS_EARNED_CHANGE ড্রাফ্ট গ্রেডের লবে পরিবর্তন।
ASSIGNED_GRADE_POINTS_EARNED_CHANGE অ্যাসাইন করা গ্রেডের লবে পরিবর্তন।
MAX_POINTS_CHANGE গ্রেডের ডিনোমিনেটরে পরিবর্তন।

পদ্ধতি

get

 স্টুডেন্টের জমা দেওয়া অ্যাসাইনমেন্ট ফেরত দেয়।

list

 অনুরোধকারীর দেখার অনুমতি আছে এমন স্টুডেন্ট জমা দেওয়ার তালিকা ফিরিয়ে দেয়, অনুরোধের OAuth স্কোপে ফ্যাক্টরিং করে।

modifyAttachments

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

patch

 স্টুডেন্টের জমা দেওয়া অ্যাসাইনমেন্টের এক বা একাধিক ফিল্ড আপডেট করে।

reclaim

 স্টুডেন্টের হয়ে তার জমা দেওয়া অ্যাসাইনমেন্ট ফিরিয়ে আনে।

return

 স্টুডেন্টের জমা দেওয়া অ্যাসাইনমেন্ট ফেরত দেয়।

turnIn

 স্টুডেন্টের জমা দেওয়া অ্যাসাইনমেন্ট জমা দেয়।