REST Resource: courses.courseWork.studentSubmissions

संसाधन: छात्र-छात्राओं का सबमिशन

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

CourseWork आइटम बनाए जाने पर StudentSubmission आइटम जनरेट होते हैं.

छात्र-छात्राओं के सबमिट किए गए ऐसे असाइनमेंट जिन्हें कभी भी ऐक्सेस नहीं किया गया है (जैसे, state = नया होना), उसमें बनाने का समय या अपडेट का समय नहीं हो सकता.

जेएसओएन के काेड में दिखाना 
{
  "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)

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

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "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)

सिर्फ़ आउटपुट के लिए. एपीआई का झलक वर्शन. 'झलक देखें' कार्यक्रम में डेवलपर को उपलब्ध कराई गई एपीआई की नई सुविधाओं को ऐक्सेस करने के लिए, इसे सेट करना ज़रूरी है.
यूनियन फ़ील्ड content. सबमिट किया गया कॉन्टेंट. खास टाइप, course_work_type की वैल्यू के आधार पर तय होता है. content इनमें से सिर्फ़ एक हो सकता है:
assignmentSubmission

object (AssignmentSubmission)

CourseWorkType के तौर पर Assignments होने पर, सबमिट किया जाने वाला कॉन्टेंट.

छात्र studentSubmissions.modifyAttachments का इस्तेमाल करके इस कॉन्टेंट में बदलाव कर सकते हैं.
shortAnswerSubmission

object (ShortAnswerSubmission)

CourseWorkType होने पर, सबमिट किया जाने वाला कॉन्टेंट छोटा_ANSWER_सवाल.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

CourseWorkType होने पर सबमिट की गई सामग्री MULTIPLE_CHOICE_सवाल.

RubricGrade

छात्र/छात्रा के सबमिशन के लिए सेट किया गया रूब्रिक ग्रेड. हर रूब्रिक शर्त के लिए ज़्यादा से ज़्यादा एक एंट्री हो सकती है.

जेएसओएन के काेड में दिखाना 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
फ़ील्ड
criterionId

string

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

string

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

number

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

AssignmentSubmission

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

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

object (Attachment)

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

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

लगाव

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

अटैचमेंट बनाते समय, form फ़ील्ड को सेट नहीं किया जा सकता.

जेएसओएन के काेड में दिखाना 
{

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

छात्र/छात्रा छोटे से सवाल का जवाब दें.

जेएसओएन के काेड में दिखाना 
{
  "answer": string
}
फ़ील्ड
answer

string

छात्र/छात्रा ने एक छोटे जवाब का जवाब दिया.

MultipleChoiceSubmission

कई विकल्प वाले सवाल के लिए छात्र/छात्रा काम करें.

जेएसओएन के काेड में दिखाना 
{
  "answer": string
}
फ़ील्ड
answer

string

छात्र/छात्रा की पसंद का विकल्प.

SubmissionHistory

सबमिशन का इतिहास. फ़िलहाल, इसमें राज्य और ग्रेड का इतिहास शामिल है.

जेएसओएन के काेड में दिखाना 
{

  // 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. सबमिट करने से जुड़े इतिहास का टाइप, State आज़माकर ग्रेड का इतिहास, में से एक हो सकता है. type इनमें से सिर्फ़ एक हो सकता है:
stateHistory

object (StateHistory)

अगर सबमिट किए गए कॉन्टेंट के राज्य का इतिहास मौजूद है, तो उसकी जानकारी.
gradeHistory

object (GradeHistory)

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

StateHistory

हर उस राज्य का इतिहास जहां यह सबमिशन हुआ है.

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

enum (State)

वर्कफ़्लो की पाइपलाइन स्टेज.
stateTimestamp

string (Timestamp format)

जब सबमिशन ने इस स्थिति में डाला था.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "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 छात्र/छात्रा ने सबमिट करने के बाद, अपने फ़ॉर्म में बदलाव कर दिया. फ़िलहाल, सवालों का इस्तेमाल सिर्फ़ तब किया जाता है, जब छात्र-छात्राएं अपने जवाब में बदलाव करते हैं.

GradeHistory

इस सबमिशन में हर ग्रेड का इतिहास.

जेएसओएन के काेड में दिखाना 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
फ़ील्ड
pointsEarned

number

सबमिशन ग्रेड के इतिहास में इस समय, ग्रेड का न्यूमरेटर.
maxPoints

number

सबमिशन ग्रेड के इतिहास में इस समय, ग्रेड का डिनॉमिनेटर.
gradeTimestamp

string (Timestamp format)

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

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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

 छात्र/छात्रा का सबमिशन.