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

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

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

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

string

उस छात्र या छात्रा के लिए आइडेंटिफ़ायर जिसने यह सबमिशन किया है.

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

string (Timestamp format)

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

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

यह RFC 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)

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

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

यह RFC 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 में उपलब्ध कराई गई नई एपीआई सुविधाओं का ऐक्सेस मिल सके.
यूनियन फ़ील्ड content. सबमिट किया गया कॉन्टेंट. यह वैल्यू, course_work_type की वैल्यू पर निर्भर करती है. content इनमें से सिर्फ़ एक हो सकता है:
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 में असाइनमेंट ऐक्सेस नहीं किया है, तो हो सकता है कि STUDENT_COPY के शेयर मोड वाली सामग्री से जुड़ी Drive फ़ाइलें अभी मौजूद न हों.

अटैचमेंट के कुछ मेटाडेटा सिर्फ़ तब भरे जाते हैं, जब अनुरोध करने वाले उपयोगकर्ता के पास इसे ऐक्सेस करने की अनुमति हो. पहचानकर्ता और alternateLink फ़ील्ड हमेशा उपलब्ध होते हैं, लेकिन अन्य फ़ील्ड (उदाहरण के लिए, टाइटल) उपलब्ध नहीं हो सकते.

अटैचमेंट

छात्र या छात्रा के असाइनमेंट में अटैचमेंट जोड़ा गया.

अटैचमेंट बनाते समय, 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)

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 के काेड में दिखाना 
{

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

अगर मौजूद हो, तो सबमिशन के ग्रेड के इतिहास की जानकारी.

StateHistory

इस सबमिशन की हर स्थिति का इतिहास.

JSON के काेड में दिखाना 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
फ़ील्ड
state

enum (State)

वर्कफ़्लो पाइपलाइन का चरण.
stateTimestamp

string (Timestamp format)

सबमिशन इस स्थिति में कब पहुंचा.

यह RFC 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)

सबमिशन का ग्रेड कब बदला गया था.

यह RFC 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

 छात्र या छात्रा का सबमिट किया गया असाइनमेंट.