REST Resource: courses.courseWork.studentSubmissions

সম্পদ: ছাত্র জমা

কোর্স কাজের জন্য ছাত্র জমা.

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

ছাত্র জমা দেওয়া যা কখনও অ্যাক্সেস করা হয়নি (যেমন state = NEW সহ) তৈরির সময় বা আপডেটের সময় নাও থাকতে পারে।

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

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
courseId

string

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

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

courseWorkId

string

এই অনুরূপ কোর্স কাজের জন্য শনাক্তকারী.

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

id

string

ছাত্র জমা দেওয়ার জন্য শ্রেণীকক্ষ-নির্ধারিত শনাক্তকারী। প্রাসঙ্গিক কোর্সের কাজের জন্য জমা দেওয়ার মধ্যে এটি অনন্য।

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

userId

string

এই জমার মালিক যে ছাত্রের জন্য শনাক্তকারী।

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

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

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

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

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

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

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

courseWorkType

enum ( CourseWorkType )

এই জমা দেওয়ার জন্য অবশ্যই কাজের ধরন।

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

associatedWithDeveloper

boolean

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

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

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

submissionHistory[]

object ( SubmissionHistory )

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

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

previewVersion

enum ( PreviewVersion )

শুধুমাত্র আউটপুট। API-এর পূর্বরূপ সংস্করণ। প্রিভিউ প্রোগ্রামে বিকাশকারীদের জন্য উপলব্ধ নতুন API ক্ষমতাগুলি অ্যাক্সেস করার জন্য এটি অবশ্যই সেট করা উচিত।

ইউনিয়ন ক্ষেত্রের content । জমা বিষয়বস্তু. নির্দিষ্ট টাইপ course_work_type মানের উপর নির্ভর করে। content নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
assignmentSubmission

object ( AssignmentSubmission )

কোর্সওয়ার্ক টাইপ অ্যাসাইনমেন্ট হলে বিষয়বস্তু জমা দিন।

শিক্ষার্থীরা studentSubmissions.modifyAttachments ব্যবহার করে এই বিষয়বস্তু পরিবর্তন করতে পারে।

shortAnswerSubmission

object ( ShortAnswerSubmission )

কোর্সওয়ার্ক টাইপ যখন SHORT_ANSWER_QUESTION হয় তখন জমা সামগ্রী৷

multipleChoiceSubmission

object ( MultipleChoiceSubmission )

যখন courseWorkType হয় MULTIPLE_CHOICE_QUESTION বিষয়বস্তু জমা দিন৷

রুব্রিকগ্রেড

ছাত্র জমা দেওয়ার জন্য একটি রুব্রিক গ্রেড সেট৷ প্রতি রুব্রিক মানদণ্ডে সর্বাধিক একটি এন্ট্রি রয়েছে৷

JSON প্রতিনিধিত্ব 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
ক্ষেত্র
criterionId

string

ঐচ্ছিক। মানদণ্ড আইডি।

levelId

string

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

points

number

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

অ্যাসাইনমেন্ট সাবমিশন

একটি নিয়োগের জন্য ছাত্র কাজ.

JSON প্রতিনিধিত্ব 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
ক্ষেত্র
attachments[]

object ( Attachment )

ছাত্র দ্বারা সংযুক্ত করা হয়েছে. STUDENT_COPY-এর শেয়ার মোড সহ উপকরণগুলির সাথে সঙ্গতিপূর্ণ ড্রাইভ ফাইলগুলি এখনও নাও থাকতে পারে যদি শিক্ষার্থী ক্লাসরুমে অ্যাসাইনমেন্ট অ্যাক্সেস না করে থাকে।

কিছু সংযুক্তি মেটাডেটা শুধুমাত্র তখনই জমা হয় যদি অনুরোধকারী ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি থাকে। শনাক্তকারী এবং বিকল্প লিঙ্ক ক্ষেত্রগুলি সর্বদা উপলব্ধ, তবে অন্যগুলি (উদাহরণস্বরূপ, শিরোনাম) নাও হতে পারে৷

সংযুক্তি

ছাত্র নিয়োগের কাজে সংযুক্তি যোগ করা হয়েছে।

সংযুক্তি তৈরি করার সময়, form ক্ষেত্র সেট করা সমর্থিত নয়।

JSON প্রতিনিধিত্ব 
{

  // Union field attachment 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 attachment.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র attachment . সংযুক্তি ডেটা। attachment নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
driveFile

object ( DriveFile )

গুগল ড্রাইভ ফাইল সংযুক্তি।

youTubeVideo

object ( YouTubeVideo )

ইউটিউব ভিডিও সংযুক্তি।

form

object ( Form )

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

সংক্ষিপ্ত উত্তর সাবমিশন

একটি সংক্ষিপ্ত উত্তর প্রশ্নের জন্য ছাত্র কাজ.

JSON প্রতিনিধিত্ব 
{
  "answer": string
}
ক্ষেত্র
answer

string

একটি সংক্ষিপ্ত-উত্তর প্রশ্নের ছাত্রদের প্রতিক্রিয়া।

একাধিক চয়েস সাবমিশন

একাধিক পছন্দের প্রশ্নের জন্য শিক্ষার্থী কাজ করে।

JSON প্রতিনিধিত্ব 
{
  "answer": string
}
ক্ষেত্র
answer

string

শিক্ষার্থীর পছন্দের পছন্দ।

জমার ইতিহাস

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

JSON প্রতিনিধিত্ব 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের type । SubmissionHistory এর প্রকার, StateHistory, GradeHistory এর মধ্যে একটি হতে পারে। type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
stateHistory

object ( StateHistory )

জমা দেওয়ার রাষ্ট্রীয় ইতিহাসের তথ্য, যদি উপস্থিত থাকে।

gradeHistory

object ( GradeHistory )

জমা দেওয়ার গ্রেড ইতিহাসের তথ্য, যদি উপস্থিত থাকে।

রাজ্যের ইতিহাস

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

JSON প্রতিনিধিত্ব 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
ক্ষেত্র
state

enum ( State )

ওয়ার্কফ্লো পাইপলাইন পর্যায়।

stateTimestamp

string ( Timestamp format)

জমা যখন এই রাজ্যে প্রবেশ.

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

actorUserId

string

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

রাজ্য

জমা দেওয়ার জন্য সম্ভাব্য রাজ্যগুলি।

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

গ্রেড হিস্ট্রি

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

JSON প্রতিনিধিত্ব 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
ক্ষেত্র
pointsEarned

number

জমা গ্রেড ইতিহাসে এই সময়ে গ্রেডের অংক।

maxPoints

number

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

gradeTimestamp

string ( Timestamp format)

জমা দেওয়ার গ্রেড পরিবর্তন করা হয়।

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

actorUserId

string

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

gradeChangeType

enum ( 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

 একটি ছাত্র জমা চালু.