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

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

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

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

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

string (Timestamp format)

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

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

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

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

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

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

object (SubmissionHistory)

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

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

enum (PreviewVersion)

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

object (AssignmentSubmission)

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

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

object (ShortAnswerSubmission)

कोर्सवर्क टाइप होने पर, सबमिट किया जाने वाला कॉन्टेंट Shorts_ANSWER_QUESTION को सही माना जाता है.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

कोर्सवर्क टाइप, 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 की फ़ाइलें अभी तक मौजूद न हों.

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

अटैचमेंट

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

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

object (StateHistory)

अगर सबमिट किया गया डेटा सबमिट किया गया है, तो राज्य के इतिहास की जानकारी.
gradeHistory

object (GradeHistory)

अगर सबमिट किया गया है, तो ग्रेड के इतिहास की जानकारी.

StateHistory

उन सभी राज्यों का इतिहास जहां यह सबमिशन रहा है.

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

enum (State)

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

string (Timestamp format)

जब सबमिशन इस स्थिति में भेजा गया.

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

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

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

number

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

number

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

string (Timestamp format)

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

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

 इससे छात्र/छात्रा का असाइनमेंट सबमिट हो जाता है.