REST Resource: courses.courseWork

संसाधन: CourseWork

कोर्स के छात्र-छात्राओं के लिए, किसी शिक्षक की ओर से बनाया गया कोर्स वर्क.

जेएसओएन के काेड में दिखाना 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
फ़ील्ड
courseId

string

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

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

string

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

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

string

इस कोर्स वर्क का टाइटल. शीर्षक, मान्य UTF-8 स्ट्रिंग होना चाहिए. इसमें 1 से 3,000 के बीच वर्ण होने चाहिए.
description

string

इस कोर्स वर्क के बारे में वैकल्पिक जानकारी. अगर यह नीति सेट है, तो ब्यौरा एक मान्य UTF-8 स्ट्रिंग होना चाहिए. इसमें 30,000 से ज़्यादा वर्ण नहीं होने चाहिए.
materials[]

object (Material)

अतिरिक्त सामग्री.

CourseWork में 20 से ज़्यादा सामग्री वाले आइटम नहीं होने चाहिए.
state

enum (CourseWorkState)

इस कोर्स वर्क की स्थिति. अगर कोई भी अंक सेट नहीं किया गया है, तो डिफ़ॉल्ट स्थिति DRAFT होती है.
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".
dueDate

object (Date)

वैकल्पिक तारीख, यूटीसी में, इस कोर्स वर्क को सबमिट करने की आखिरी तारीख है. अगर dueTime बताया गया है, तो यह बताना ज़रूरी है.
dueTime

object (TimeOfDay)

दिन का वैकल्पिक समय, यूटीसी में, इस कोर्स वर्क को सबमिट करने की आखिरी तारीख है. अगर dueDate बताया गया है, तो यह बताना ज़रूरी है.
scheduledTime

string (Timestamp format)

इस कोर्स के कॉन्टेंट को पब्लिश होने के लिए शेड्यूल किए जाने पर, वैकल्पिक टाइमस्टैंप.

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

number

इस कोर्स वर्क के लिए ज़्यादा से ज़्यादा ग्रेड. अगर इसकी वैल्यू शून्य या सेट नहीं की गई है, तो यह माना जाएगा कि इस असाइनमेंट को ग्रेड नहीं दिया गया है. यह एक गैर-ऋणात्मक पूर्णांक मान होना चाहिए.
workType

enum (CourseWorkType)

यह कोर्स वर्क किस तरह का है.

टाइप तब सेट किया जाता है, जब कोर्स वर्क बनाया जाता है और उसे बदला नहीं जा सकता.
associatedWithDeveloper

boolean

यह कोर्स वर्क आइटम, अनुरोध करने वाले Developer Console प्रोजेक्ट से जुड़ा है या नहीं.

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

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

enum (AssigneeMode)

कोर्सवर्क का असाइनी मोड. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू ALL_STUDENTS होती है.
individualStudentsOptions

object (IndividualStudentsOptions)

कोर्सवर्क का ऐक्सेस रखने वाले छात्र-छात्राओं के आइडेंटिफ़ायर. यह फ़ील्ड सिर्फ़ तब सेट किया जाता है, जब assigneeMode INDIVIDUAL_STUDENTS हो. अगर assigneeMode, INDIVIDUAL_STUDENTS है, तो सिर्फ़ इस फ़ील्ड में बताए गए छात्र-छात्राओं को ही कोर्सवर्क असाइन किया जाएगा.
submissionModificationMode

enum (SubmissionModificationMode)

यह तय करने की सेटिंग कि छात्र-छात्राएं, सबमिशन में बदलाव कब कर सकते हैं. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू MODIFIABLE_UNTIL_TURNED_IN होती है.
creatorUserId

string

कोर्सवर्क बनाने वाले उपयोगकर्ता का आइडेंटिफ़ायर.

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

string

उस विषय का आइडेंटिफ़ायर जिससे यह कोर्सवर्क जुड़ा है. कोर्स के किसी मौजूदा विषय से मेल खाना चाहिए.
gradeCategory

object (GradeCategory)

वह कैटगरी जिसमें इस कोर्सवर्क के ग्रेड का योगदान होता है. यह जानकारी सिर्फ़ तब दी जाती है, जब कोर्सवर्क के लिए कोई कैटगरी चुनी गई हो. इसका इस्तेमाल कुल ग्रेड की गिनती करने के लिए किया जा सकता है.

सिर्फ़ पढ़ने के लिए.
यूनियन फ़ील्ड details. ऐसी अतिरिक्त जानकारी जो खास तौर पर किसी तरह के कोर्स वर्क के लिए हो. details इनमें से सिर्फ़ एक हो सकता है:
assignment

object (Assignment)

असाइनमेंट की जानकारी. यह सिर्फ़ तब अपने-आप भर जाता है, जब workType का मान ASSIGNMENT हो.

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

object (MultipleChoiceQuestion)

कई विकल्प वाले सवाल की जानकारी. रीड की कार्रवाइयों के लिए, इस फ़ील्ड में जानकारी सिर्फ़ तब अपने-आप भर जाती है, जब workType का मान MULTIPLE_CHOICE_QUESTION हो. राइट ऑपरेशन के लिए, MULTIPLE_CHOICE_QUESTION के workType के साथ कोर्स वर्क बनाते समय इस फ़ील्ड को तय किया जाना चाहिए और इसे किसी और तरह से सेट नहीं किया जाना चाहिए.

CourseWorkState

कोर्स वर्क की संभावित स्थितियां.

Enums
COURSE_WORK_STATE_UNSPECIFIED कोई राज्य दर्ज नहीं है. इसे कभी वापस नहीं किया जाता.
PUBLISHED पब्लिश किए जा चुके कॉन्टेंट की स्थिति. यह डिफ़ॉल्ट स्थिति है.
DRAFT उस काम की स्थिति जो अभी तक प्रकाशित नहीं हुआ है. इस राज्य में काम करने का ऐक्सेस, सिर्फ़ कोर्स के शिक्षकों और डोमेन एडमिन को दिखता है.
DELETED उस काम की स्थिति जो पब्लिश हो गया था, लेकिन अब मिटा दिया गया है. इस राज्य में काम करने का ऐक्सेस, सिर्फ़ कोर्स के शिक्षकों और डोमेन एडमिन को दिखता है. इस राज्य में मौजूद काम को कुछ समय बाद मिटा दिया जाता है.

SubmissionModificationMode

छात्र-छात्राओं को सबमिट करने के लिए, मोड में बदलाव किए जा सकते हैं.

Enums
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED बदलाव करने का कोई मोड मौजूद नहीं है. इसे कभी वापस नहीं किया जाता.
MODIFIABLE_UNTIL_TURNED_IN सबमिट किए जाने से पहले, सबमिशन में बदलाव किया जा सकता है.
MODIFIABLE सबमिशन में किसी भी समय बदलाव किया जा सकता है.

Assignment

असाइनमेंट के बारे में ज़्यादा जानकारी.

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

object (DriveFolder)

Drive फ़ोल्डर जहां छात्र-छात्राओं के सबमिट किए गए अटैचमेंट को रखा जाता है. यह जानकारी सिर्फ़ कोर्स के शिक्षकों और एडमिन के लिए भरी जाती है.

MultipleChoiceQuestion

कई विकल्प वाले सवालों के लिए ज़्यादा जानकारी.

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

string

संभव विकल्प.

तरीके

create

 इससे कोर्स वर्क बन जाता है.

delete

 कोर्स वर्क को मिटाया जाता है.

get

 कोर्स वर्क दिखाता है.

getAddOnContext

 Classroom ऐड-ऑन के लिए, किसी खास पोस्ट के हिसाब से मेटाडेटा की जानकारी मिलती है.

list

 यह फ़ंक्शन उस कोर्स वर्क की सूची दिखाता है जिसे देखने का अनुरोध करने वाले के पास अनुमति है.

modifyAssignees

 असाइनी मोड और कोर्सवर्क के विकल्पों में बदलाव किया जाता है.

patch

 कोर्स वर्क के एक या उससे ज़्यादा फ़ील्ड को अपडेट करता है.