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)

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

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

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

string (Timestamp format)

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

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

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

सबमिशन कॉन्टेंट, जब 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)

सबमिशन की स्थिति कब बदली.

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

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