REST Resource: courses.courseWork.studentSubmissions

संसाधन: StudentSubmission

कोर्स वर्क के लिए छात्र या छात्रा का सबमिशन.

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

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
फ़ील्ड
courseId

string

कोर्स का आइडेंटिफ़ायर.

सिर्फ़ पढ़ने के लिए.
courseWorkId

string

कोर्सवर्क का आइडेंटिफ़ायर, जिससे यह जुड़ा है.

सिर्फ़ पढ़ने के लिए.
id

string

छात्र या छात्रा के सबमिट किए गए असाइनमेंट के लिए, Classroom से असाइन किया गया आइडेंटिफ़ायर. यह कोर्स वर्क के लिए सबमिट किए गए अन्य असाइनमेंट से अलग है.

सिर्फ़ पढ़ने के लिए.
userId

string

इस सबमिशन के मालिक छात्र/छात्रा का आइडेंटिफ़ायर.

सिर्फ़ पढ़ने के लिए.
creationTime

string (Timestamp format)

इस सबमिशन को बनाने का समय. अगर छात्र या छात्रा ने इस आइटम को ऐक्सेस नहीं किया है, तो हो सकता है कि यह सेट न हो.

सिर्फ़ पढ़ने के लिए.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

इस सबमिशन को पिछली बार अपडेट किए जाने का समय. अगर छात्र या छात्रा ने इस आइटम को ऐक्सेस नहीं किया है, तो हो सकता है कि यह सेट न हो.

सिर्फ़ पढ़ने के लिए.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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))

रूब्रिक की शर्त के आधार पर, रूब्रिक के ग्रेड असाइन किए गए.

अगर इस कोर्सवर्क में कोई रूब्रिक अटैच नहीं है, तो यह मैप खाली रहेगा. इसके अलावा, अगर कोई रूब्रिक अटैच है, लेकिन किसी भी शर्त के लिए ग्रेड सेट नहीं किए गए हैं, तो भी यह मैप खाली रहेगा. एंट्री सिर्फ़ उन ग्रेड के लिए अपने-आप भरी जाती हैं जो सेट किए गए हैं. कुंजी: रूब्रिक का मानदंड आईडी.

सिर्फ़ पढ़ने के लिए.

एक ऑब्जेक्ट, जिसमें "key": value जोड़ों की सूची शामिल हो. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

यह सबमिशन किस तरह के कोर्स वर्क के लिए है.

सिर्फ़ पढ़ने के लिए.
associatedWithDeveloper

boolean

क्या छात्र या छात्रा का यह सबमिशन, अनुरोध करने वाले Developer Console प्रोजेक्ट से जुड़ा है.

ज़्यादा जानकारी के लिए, courseWork.create पर जाएं.

सिर्फ़ पढ़ने के लिए.
submissionHistory[]

object (SubmissionHistory)

सबमिट किए गए असाइनमेंट का इतिहास. इसमें असाइनमेंट की स्थिति और ग्रेड का इतिहास शामिल है.

सिर्फ़ पढ़ने के लिए.
previewVersion

enum (PreviewVersion)

सिर्फ़ आउटपुट के लिए. एपीआई के वर्शन की झलक. Preview Program में डेवलपर के लिए उपलब्ध कराई गई नई एपीआई सुविधाओं को ऐक्सेस करने के लिए, इसे सेट करना ज़रूरी है.
सबमिट किया गया कॉन्टेंट. यह टाइप, 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

ज़रूरी नहीं. मानदंड आईडी.
levelId

string

ज़रूरी नहीं. चुने गए लेवल का वैकल्पिक लेवल आईडी. अगर यह खाली है, तो इसका मतलब है कि कोई लेवल नहीं चुना गया है.
points

number

ज़रूरी नहीं. इस मापदंड के लिए असाइन किए गए वैकल्पिक पॉइंट. आम तौर पर, ये पॉइंट लेवल के हिसाब से असाइन किए जाते हैं. ऐसा हो सकता है कि लेवल में पॉइंट हों या न हों. अगर यह सेट नहीं है, तो इस शर्त के लिए कोई पॉइंट सेट नहीं किया गया है.

AssignmentSubmission

किसी असाइनमेंट के लिए छात्र/छात्रा का काम.

JSON के काेड में दिखाना 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
फ़ील्ड
attachments[]

object (Attachment)

छात्र या छात्रा ने अटैचमेंट जोड़े हों. अगर छात्र या छात्रा ने Classroom में असाइनमेंट को ऐक्सेस नहीं किया है, तो हो सकता है कि Drive में वे फ़ाइलें मौजूद न हों जो STUDENT_COPY के शेयर मोड वाले मटीरियल से जुड़ी हैं.

अटैचमेंट का कुछ मेटाडेटा सिर्फ़ तब पॉप्युलेट होता है, जब अनुरोध करने वाले उपयोगकर्ता के पास उसे ऐक्सेस करने की अनुमति हो. 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)

सबमिट किए गए कॉन्टेंट की स्थिति कब बदली.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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)

सबमिट किए गए असाइनमेंट का ग्रेड कब बदला गया.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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

 छात्र-छात्रा का सबमिट किया गया असाइनमेंट वापस करता है.